MFPutWorkItem 函数 (mfapi.h)

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

Syntax

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

参数

[in] dwQueue

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

[in] pCallback

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

[in] pState

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

返回值

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

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

注解

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

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows操作系统
Header mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

另请参阅

MFPutWorkItemEx

Media Foundation Functions

工作队列