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

Weitere Informationen

Media Foundation-Funktionen

Verbesserungen bei Arbeitswarteschlange und Threading

Arbeitswarteschlangen