MFPutWorkItem2-Funktion (mfapi.h)

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

Syntax

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

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. Arbeitselemente 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, 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

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.

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