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

Vedi anche

DispatcherQueue

DispatcherQueueController