Freigeben über


MFPutWorkItem2-Funktion (mfapi.h)

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

Syntax

HRESULT MFPutWorkItem2(
  [in] DWORD            dwQueue,
  [in] LONG             Priority,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

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. Arbeitsaufgaben werden in der Reihenfolge der Priorität ausgeführt.

[in] pCallback

Ein Zeiger auf die IMFAsyncCallback-Schnittstelle . Der Aufrufer muss diese Schnittstelle implementieren.

[in] pState

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

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.

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