MFCancelWorkItem 函数 (mfapi.h)
尝试取消使用 MFScheduleWorkItem 或 MFScheduleWorkItemEx 计划的异步操作。
语法
HRESULT MFCancelWorkItem(
[in] MFWORKITEM_KEY Key
);
parameters
[in] Key
在 MFScheduleWorkItem、MFScheduleWorkItemEx 或 MFPutWaitingWorkItem 函数的 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 |