MFPutWorkItem-Funktion (mfapi.h)

Fügt einen asynchronen Vorgang in eine Arbeitswarteschlange ein.

Syntax

HRESULT MFPutWorkItem(
  [in] DWORD            dwQueue,
  [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] 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ültige Arbeitswarteschlange. Weitere Informationen finden Sie unter IMFAsyncCallback::GetParameters.
MF_E_SHUTDOWN	Die MFStartup-Funktion wurde nicht aufgerufen, oder MFShutdown wurde aufgerufen.

Bemerkungen

Diese Funktion erstellt ein asynchrones Ergebnisobjekt und fügt das Ergebnisobjekt in die Arbeitswarteschlange ein. Die Arbeitswarteschlange ruft die durch pCallback angegebene IMFAsyncCallback::Invoke-Methode auf.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	mfapi.h
Library	Mfplat.lib
DLL	Mfplat.dll

Siehe auch

MFPutWorkItemEx-

Media Foundation-Funktionen

Arbeitswarteschlangen