MFScheduleWorkItem 函数 (mfapi.h)

计划异步操作在指定的间隔后完成。

语法

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

参数

[in] pCallback

指向 IMFAsyncCallback 接口的指针。 调用方必须实现此接口。

[in] pState

指向由调用方定义的状态对象的 IUnknown 接口的指针。 此参数可以为 NULL。 可以使用此对象来保存状态信息。 调用回调时，对象将返回到调用方。

[in] Timeout

超时间隔（以毫秒为单位）。 将此参数设置为负值。 回调在 •Timeout 毫秒之后调用。 例如，如果 Timeout 为 5000，则回调在 5000 毫秒后调用。

[out] pKey

接收可用于取消计时器的密钥。 若要取消计时器，请调用 MFCancelWorkItem 并在 Key 参数中传递此密钥。

返回值

函数返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	函数成功。

注解

此函数创建异步结果对象。 计时器间隔过后，将调用 pCallback 指定的 IMFAsyncCallback：：Invoke 方法。

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

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

要求

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

另请参阅

MFScheduleWorkItemEx

媒体基础函数

工作队列