MFCancelWorkItem-Funktion (mfapi.h)

Versucht, einen asynchronen Vorgang abzubrechen, der mit MFScheduleWorkItem oder MFScheduleWorkItemEx geplant wurde.

Syntax

HRESULT MFCancelWorkItem(
  [in] MFWORKITEM_KEY Key
);

Parameter

[in] Key

Der Schlüssel, der im pKey-Parameter der Funktionen MFScheduleWorkItem, MFScheduleWorkItemEx oder MFPutWaitingWorkItem empfangen wurde.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Da Arbeitselemente asynchron sind, wird der Arbeitselementrückruf möglicherweise weiterhin aufgerufen, nachdem MFCancelWorkItem aufgerufen wurde.

Diese Funktion ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Komponenten des Windows Media Format 11 SDK 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

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

Weitere Informationen

Media Foundation-Funktionen

Arbeitswarteschlangen