MFPutWorkItemEx2-Funktion (mfapi.h)

Legt einen asynchronen Vorgang für eine Arbeitswarteschlange mit einer angegebenen Priorität ab.

Syntax

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

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 des Arbeitselements. 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. Um das Ergebnisobjekt zu erstellen, rufen Sie MFCreateAsyncResult auf.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

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

Hinweise

Zum Aufrufen des Arbeitselements übergibt diese Funktion pResult an die MFInvokeCallback-Funktion . Der Rückruf wird angegeben, wenn Sie das von pResult angegebene Ergebnisobjekt erstellen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

Media Foundation-Funktionen

Verbesserungen bei Arbeitswarteschlange und Threading

Arbeitswarteschlangen