MFBeginRegisterWorkQueueWithMMCSS-Funktion (mfapi.h)
Ordnet eine Arbeitswarteschlange einem MMCSS-Task (Multimedia Class Scheduler Service) zu.
Syntax
HRESULT MFBeginRegisterWorkQueueWithMMCSS(
[in] DWORD dwWorkQueueId,
[in] LPCWSTR wszClass,
[in] DWORD dwTaskId,
[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. Um einen neuen Aufgabenbezeichner zu erhalten, legen Sie diesen Wert auf 0 fest.
[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, der vom Aufrufer definiert wird. Dieser Parameter kann NULL sein. Sie können dieses Objekt verwenden, um Zustandsinformationen aufzunehmen. Das -Objekt wird an den Aufrufer zurückgegeben, wenn der Rückruf aufgerufen wird.
Rückgabewert
Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Funktion wurde erfolgreich ausgeführt. |
Hinweise
Diese Funktion ist asynchron. Nach Abschluss des Vorgangs wird die IMFAsyncCallback::Invoke-Methode des Rückrufobjekts aufgerufen. Zu diesem Zeitpunkt sollte die Anwendung MFEndRegisterWorkQueueWithMMCSS aufrufen, um die asynchrone Anforderung abzuschließen.
Um die Registrierung der Arbeitswarteschlange aus dem MMCSS-Task aufzuheben, rufen Sie MFBeginUnregisterWorkQueueWithMMCSS auf.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mfapi.h |
| Bibliothek | Mfplat.lib |
| DLL | Mfplat.dll |