MFScheduleWorkItem-Funktion (mfapi.h)

  • Artikel

Plant den Abschluss eines asynchronen Vorgangs nach einem angegebenen Intervall.

Syntax

HRESULT MFScheduleWorkItem(
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *pState,
  [in]  INT64            Timeout,
  [out] MFWORKITEM_KEY   *pKey
);

Parameter

[in] pCallback

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

[in] pState

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 aufzunehmen. Das -Objekt wird an den Aufrufer zurückgegeben, wenn der Rückruf aufgerufen wird.

[in] Timeout

Timeoutintervall in Millisekunden. Legen Sie diesen Parameter auf einen negativen Wert fest. Der Rückruf wird nach −Timeout millisekunden aufgerufen. Wenn das Timeout beispielsweise −5000 ist, wird der Rückruf nach 5000 Millisekunden aufgerufen.

[out] pKey

Empfängt einen Schlüssel, der zum Abbrechen des Timers verwendet werden kann. Um den Timer abzubrechen, rufen Sie MFCancelWorkItem auf, und übergeben Sie diesen Schlüssel im Key-Parameter .

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Funktion wurde erfolgreich ausgeführt.

Hinweise

Diese Funktion erstellt ein asynchrones Ergebnisobjekt. Wenn das Timerintervall verstrichen ist, wird die von pCallback angegebene IMFAsyncCallback::Invoke-Methode aufgerufen.

Diese Funktion ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition vom Oktober 2006) installiert.

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

MFScheduleWorkItemEx

Media Foundation-Funktionen

Arbeitswarteschlangen