Inizializzazione e terminazione del contesto di callback

Prima che la routine di callback della coda predefinita possa essere usata, specificandola come routine di callback durante il commit di una coda di file o chiamandola da una routine di callback personalizzata, deve essere inizializzata.

La funzione SetupInitDefaultQueueCallback compila la struttura del contesto usata dalla routine di callback della coda predefinita. Restituisce un puntatore void a tale struttura. Questa struttura è essenziale per l'operazione di callback predefinita e deve essere passata alla routine di callback. È possibile specificare il puntatore void come contesto in una chiamata a SetupCommitFileQueue oppure specificando il puntatore void come parametro di contesto quando si chiama SetupDefaultQueueCallback da una routine di callback personalizzata. Questa struttura di contesto non deve essere modificata o a cui fa riferimento l'applicazione di installazione.

La funzione SetupInitDefaultQueueCallbackEx inizializza anche un contesto per la routine di callback della coda predefinita, ma specifica una seconda finestra per ricevere un messaggio di stato specificato dal chiamante ogni volta che la coda invia una notifica. In questo modo è possibile usare le finestre di dialogo predefinite per la richiesta e l'errore del disco e incorporare anche una barra di stato in una seconda finestra, ad esempio in una pagina di un'installazione guidata.

Indipendentemente dal fatto che sia stato inizializzato il contesto utilizzato dalla routine di callback della coda predefinita con SetupInitDefaultQueueCallback o SetupInitDefaultQueueCallbackEx, dopo aver completato l'elaborazione delle operazioni accodate, chiamare SetupTermDefaultQueueCallback per rilasciare le risorse allocate per inizializzare la struttura del contesto.