MFCancelWorkItem 函数 (mfapi.h)

尝试取消使用 MFScheduleWorkItem 或 MFScheduleWorkItemEx 计划的异步操作。

语法

HRESULT MFCancelWorkItem(
  [in] MFWORKITEM_KEY Key
);

parameters

[in] Key

MFScheduleWorkItem、MFScheduleWorkItemExMFPutWaitingWorkItem 函数的 pKey 参数中收到的密钥。

返回值

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

由于工作项是异步的,因此在调用 MFCancelWorkItem 后可能仍会调用工作项回调。

如果安装了 Windows Media Format 11 SDK 可再发行组件,则此函数在以下平台上可用:

  • Windows XP with Service Pack 2 (SP2) 及更高版本。
  • Windows XP Media Center Edition 2005 KB900325 (windows XP Media Center Edition 2005) 和KB925766 (2006 年 10 月 Windows XP Media Center Edition 更新汇总) 安装。

要求

   
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

另请参阅

媒体基础函数

工作队列