MFBeginRegisterWorkQueueWithMMCSS-Funktion (mfapi.h)

  • Artikel

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
S_OK
 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

Weitere Informationen

Media Foundation-Funktionen

Arbeitswarteschlangen