Funzione MFBeginRegisterWorkQueueWithMMCSSEx (mfapi.h)

Articolo
02/28/2024

Associa una coda di lavoro a un'attività MMCSS (Multimedia Class Scheduler Service).

Sintassi

HRESULT MFBeginRegisterWorkQueueWithMMCSSEx(
  [in] DWORD            dwWorkQueueId,
  [in] LPCWSTR          wszClass,
  [in] DWORD            dwTaskId,
  [in] LONG             lPriority,
  [in] IMFAsyncCallback *pDoneCallback,
  [in] IUnknown         *pDoneState
);

Parametri

[in] dwWorkQueueId

Identificatore della coda di lavoro. Per le code di lavoro private, l'identificatore viene restituito dalla funzione MFAllocateWorkQueue . Per le code di lavoro della piattaforma, vedere Identificatori della coda di lavoro.

[in] wszClass

Nome dell'attività MMCSS. Per altre informazioni, vedere Servizio utilità di pianificazione classi multimediali.

[in] dwTaskId

Identificatore di attività univoco. Per ottenere un nuovo identificatore di attività, impostare questo valore su zero.

[in] lPriority

Priorità relativa di base per i thread della coda di lavoro. Per altre informazioni, vedere AvSetMmThreadPriority.

[in] pDoneCallback

Puntatore all'interfaccia IMFAsyncCallback di un oggetto callback. Il chiamante deve implementare questa interfaccia.

[in] pDoneState

Puntatore all'interfaccia IUnknown di un oggetto state, definito dal chiamante. Questo parametro può essere NULL. È possibile usare questo oggetto per contenere informazioni sullo stato. L'oggetto viene restituito al chiamante quando viene richiamato il callback.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione estende la funzione MFBeginRegisterWorkQueueWithMMCSS aggiungendo il parametro lPriority .

Questa funzione è asincrona. Al termine dell'operazione, viene chiamato il metodo FMAsyncCallback::Invoke dell'oggetto callback. A questo punto, chiamare MFEndRegisterWorkQueueWithMMCSS per completare la richiesta asincrona.

Per annullare la registrazione della coda di lavoro dall'attività MMCSS, chiamare MFBeginUnregisterWorkQueueWithMMCSS.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mfapi.h
DLL	Mfplat.dll

Vedi anche

Funzioni di Media Foundation

Miglioramenti della coda di lavoro e del threading

Code di lavoro

Condividi tramite