MFBeginRegisterWorkQueueWithMMCSSEx-Funktion (mfapi.h)
Ordnet eine Arbeitswarteschlange einem MMCSS-Task (Multimedia Class Scheduler Service) zu.
Syntax
HRESULT MFBeginRegisterWorkQueueWithMMCSSEx(
[in] DWORD dwWorkQueueId,
[in] LPCWSTR wszClass,
[in] DWORD dwTaskId,
[in] LONG lPriority,
[in] IMFAsyncCallback *pDoneCallback,
[in] IUnknown *pDoneState
);
Parameter
[in] dwWorkQueueId
Der Bezeichner der Arbeitswarteschlange. Für private Arbeitswarteschlangen wird der Bezeichner von der MFAllocateWorkQueue-Funktion zurückgegeben. Informationen zu Plattformarbeitswarteschlangen finden Sie unter Arbeitswarteschlangenbezeichner.
[in] wszClass
Der Name des MMCSS-Tasks. Weitere Informationen finden Sie unter Multimedia Class Scheduler Service.
[in] dwTaskId
Der eindeutige Aufgabenbezeichner. Legen Sie diesen Wert auf 0 (null) fest, um einen neuen Aufgabenbezeichner zu erhalten.
[in] lPriority
Die relative Basispriorität für die Arbeitswarteschlangenthreads. Weitere Informationen finden Sie unter AvSetMmThreadPriority.
[in] pDoneCallback
Ein Zeiger auf die IMFAsyncCallback-Schnittstelle eines Rückrufobjekts. Der Aufrufer muss diese Schnittstelle implementieren.
[in] pDoneState
Ein Zeiger auf die IUnknown-Schnittstelle eines Zustandsobjekts, das vom Aufrufer definiert wird. Dieser Parameter kann NULL sein. Sie können dieses Objekt verwenden, um Zustandsinformationen zu enthalten. Das -Objekt wird an den Aufrufer zurückgegeben, wenn der Rückruf aufgerufen wird.
Rückgabewert
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Funktion erweitert die MFBeginRegisterWorkQueueWithMMCSS-Funktion durch Hinzufügen des lPriority-Parameters .
Diese Funktion ist asynchron. Nach Abschluss des Vorgangs wird die IMFAsyncCallback::Invoke-Methode des Rückrufobjekts aufgerufen. Rufen Sie an diesem Punkt MFEndRegisterWorkQueueWithMMCSS auf, um die asynchrone Anforderung abzuschließen.
Um die Registrierung der Arbeitswarteschlange aus der MMCSS-Aufgabe aufzuheben, rufen Sie MFBeginUnregisterWorkQueueWithMMCSS auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mfapi.h |
| DLL | Mfplat.dll |