MFPutWorkItem-Funktion (mfapi.h)

  • Artikel

Fügt einen asynchronen Vorgang in eine Arbeitswarteschlange ein.

Syntax

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

Hinweise

Diese Funktion erstellt ein asynchrones Ergebnisobjekt und platziert das Ergebnisobjekt in der Arbeitswarteschlange. Die Arbeitswarteschlange ruft die von pCallback angegebene IMFAsyncCallback::Invoke-Methode auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

MFPutWorkItemEx

Media Foundation-Funktionen

Arbeitswarteschlangen