Freigeben über


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