Funzione CreateDispatcherQueueController (dispatcherqueue.h)
Crea un dispatcherQueueController. Usare dispatcherQueueController creato per creare e gestire la durata di un dispatcherQueue per eseguire attività in coda in ordine di priorità nel thread del dispatcher.
Sintassi
HRESULT CreateDispatcherQueueController(
[in] DispatcherQueueOptions options,
[out] PDISPATCHERQUEUECONTROLLER *dispatcherQueueController
);
Parametri
[in] options
Affinità di threading e tipo di appartamento COM per la creazione di DispatcherQueueController. Per informazioni dettagliate, vedere le osservazioni.
[out] dispatcherQueueController
Controller di coda del dispatcher creato.
Valore restituito
S_OK per il successo; in caso contrario, un codice di errore.
Commenti
Introdotta in Windows 10 versione 1709.
Se options.threadType è DQTYPE_THREAD_DEDICATED, questa funzione crea un thread, la inizializza con l'appartamento COM specificato e associa un dispatcherQueue a tale thread. Il ciclo di eventi della coda dispatcher viene eseguito nel nuovo thread dedicato fino a quando la coda dispatcher non viene arrestata in modo esplicito. Per evitare perdite di thread e memoria, chiamare DispatcherQueueController.ShutdownQueueAsync al termine della coda del dispatcher.
Se options.threadType è DQTYPE_THREAD_CURRENT, viene creato un dispatcherQueue e associato al thread corrente. Si verifica un errore se è già presente un dispatcherQueue associato al thread corrente. Il thread corrente deve pompare i messaggi per consentire alla coda del dispatcher di inviare attività. Prima dell'uscita dal thread corrente, deve chiamare DispatcherQueueController.ShutdownQueueAsync e continuare a pompare i messaggi fino al completamento dell'operazione IAsyncAction .
Questa chiamata non viene restituita finché non viene creato il thread DispatcherQueueController e il nuovo thread (se presente).
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | dispatcherqueue.h |
| Libreria | CoreMessaging.lib |
| DLL | CoreMessaging.dll |