MFBeginRegisterWorkQueueWithMMCSSEx-Funktion (mfapi.h)

Ordnet eine Arbeitswarteschlange einem MMCSS-Vorgang (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
);

Die Parameter

[in] dwWorkQueueId

Der Bezeichner der Arbeitswarteschlange. Bei privaten Arbeitswarteschlangen wird der Bezeichner von der FUNKTION MFAllocateWorkQueue zurückgegeben. Informationen zu Plattformarbeitswarteschlangen finden Sie unter Arbeitswarteschlangenbezeichner.

[in] wszClass

Der Name der MMCSS-Aufgabe. Weitere Informationen finden Sie unter Multimedia Class Scheduler Service.

[in] dwTaskId

Der eindeutige Vorgangsbezeichner. Um einen neuen Vorgangsbezeichner zu erhalten, legen Sie diesen Wert auf Null fest.

[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 Statusinformationen zu speichern. 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 HRESULT-Fehlercode zurückgegeben.

Bemerkungen

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 zu diesem Zeitpunkt MFEndRegisterWorkQueueWithMMCSS auf, um die asynchrone Anforderung abzuschließen.

Um die Registrierung der Arbeitswarteschlange von der MMCSS-Aufgabe aufzuheben, rufen Sie MFBeginUnregisterWorkQueueWithMMCSS auf.

Anforderungen

Siehe auch

Media Foundation-Funktionen

Verbesserungen bei Der Arbeitswarteschlange und Threading

Arbeitswarteschlangen