MFPutWorkItemEx2-Funktion (mfapi.h)

Platziert einen asynchronen Vorgang in einer Arbeitswarteschlange mit einer angegebenen Priorität.

Syntax

HRESULT MFPutWorkItemEx2(
  [in] DWORD          dwQueue,
  [in] LONG           Priority,
  [in] IMFAsyncResult *pResult
);

Die Parameter

[in] dwQueue

Der Bezeichner für die Arbeitswarteschlange. Dieser Wert kann eine der standardmäßigen Media Foundation-Arbeitswarteschlangen oder eine von der Anwendung erstellte Arbeitswarteschlange angeben. Eine Liste der standardmäßigen Media Foundation-Arbeitswarteschlangen finden Sie unter Arbeitswarteschlangenbezeichner. Um eine neue Arbeitswarteschlange zu erstellen, rufen Sie MFAllocateWorkQueue oder MFAllocateWorkQueueEx auf.

[in] Priority

Die Priorität der Arbeitsaufgabe. Dieser Wert sollte 1, 0 oder -1 sein. Elemente mit dem Wert 1 werden vor Elementen mit dem Wert 0 ausgeführt. Elemente mit dem Wert -1 werden nach Elementen mit dem Wert 0 ausgeführt.

[in] pResult

Ein Zeiger auf die IMFAsyncResult-Schnittstelle eines asynchronen Ergebnisobjekts. Rufen Sie zum Erstellen des Ergebnisobjekts MFCreateAsyncResult auf.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind:

Rückgabecode	Description
S_OK	Erfolg.
MF_E_INVALID_WORKQUEUE	Ungültiger Arbeitswarteschlangenbezeichner.
MF_E_SHUTDOWN	Die MFStartup-Funktion wurde nicht aufgerufen, oder MFShutdown wurde aufgerufen.

Bemerkungen

Um die Arbeitsaufgabe aufzurufen, übergibt diese Funktion pResult an die MFInvokeCallback-Funktion . Der Rückruf wird angegeben, wenn Sie das durch pResult angegebene Ergebnisobjekt erstellen.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows 8 [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform	Fenster
Header	mfapi.h
Library	Mfplat.lib
DLL	Mfplat.dll

Siehe auch

Media Foundation-Funktionen

Verbesserungen bei Der Arbeitswarteschlange und Threading

Arbeitswarteschlangen