Funzione MFAllocateWorkQueueEx (mfapi.h)

Articolo
08/24/2023

Crea una nuova coda di lavoro. Questa funzione estende le funzionalità della funzione MFAllocateWorkQueue rendendo possibile creare una coda di lavoro con un ciclo di messaggi.

Sintassi

HRESULT MFAllocateWorkQueueEx(
  [in]  MFASYNC_WORKQUEUE_TYPE WorkQueueType,
  [out] DWORD                  *pdwWorkQueue
);

Parametri

[in] WorkQueueType

Membro dell'enumerazione MFASYNC_WORKQUEUE_TYPE , specificando il tipo di coda di lavoro da creare.

Valore	Significato
MF_MULTITHREADED_WORKQUEUE	Creare una coda di lavoro multithreaded. In genere, le applicazioni non devono creare code multithreaded private. Usare invece le code multithreaded della piattaforma. Per altre informazioni, vedere Miglioramenti alla coda di lavoro e al threading.
MF_STANDARD_WORKQUEUE	Creare una coda di lavoro senza un ciclo di messaggi. L'uso di questo flag equivale a chiamare MFAllocateWorkQueue.
MF_WINDOW_WORKQUEUE	Creare una coda di lavoro con un ciclo di messaggi. Il thread che invia gli elementi di lavoro per questa coda chiamerà anche PeekMessage e DispatchMessage. Usare questa opzione se il callback esegue eventuali azioni che richiedono un ciclo di messaggi.

[out] pdwWorkQueue

Riceve un identificatore per la coda di lavoro creata.

Valore restituito

La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Funzione completata.
E_FAIL	L'applicazione ha superato il numero massimo di code di lavoro.
E_INVALIDARG	Argomento non valido.
MF_E_SHUTDOWN	L'applicazione non ha chiamato MFStartup o l'applicazione ha già chiamato MFShutdown.

Commenti

Al termine dell'uso della coda di lavoro, chiamare MFUnlockWorkQueue.

La funzione MFAllocateWorkQueue equivale a chiamare MFAllocateWorkQueueEx con il valore MF_STANDARD_WORKQUEUE per il parametro WorkQueueType .

Questa funzione è disponibile in Windows Vista se è installato l'supplemento per l'aggiornamento della piattaforma per Windows Vista.

Requisiti

Requisito	Valore
Client minimo supportato	Supplemento di Windows 7, Windows Vista e Aggiornamento piattaforma per Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfapi.h
Libreria	Mfplat.lib
DLL	Mfplat.dll

Vedi anche

MFPutWorkItem

MFPutWorkItemEx

Funzioni di Media Foundation

Code di lavoro

Condividi tramite