MFPutWorkItem 函数 (mfapi.h)

将异步操作放在工作队列上。

语法

HRESULT MFPutWorkItem(
  [in] DWORD            dwQueue,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

参数

[in] dwQueue

工作队列的标识符。 此值可以指定其中一个标准 Media Foundation 工作队列,或应用程序创建的工作队列。 有关标准媒体基础工作队列的列表,请参阅 工作队列标识符。 若要创建新的工作队列,请调用 MFAllocateWorkQueueMFAllocateWorkQueueEx

[in] pCallback

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

[in] pState

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

返回值

返回 HRESULT 值。 可能的值包括以下值。

返回代码 说明
S_OK
成功。
MF_E_INVALID_WORKQUEUE
无效的工作队列。 有关详细信息,请参阅 IMFAsyncCallback::GetParameters
MF_E_SHUTDOWN
未调用 MFStartup 函数,或调用 了 MFShutdown

注解

此函数创建一个异步结果对象,并将结果对象置于工作队列中。 工作队列调用由 pCallback 指定的 IMFAsyncCallback::Invoke 方法。

要求

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

另请参阅

MFPutWorkItemEx

媒体基础函数

工作队列