MFPutWorkItemEx2 函数 (mfapi.h)

将异步操作置于具有指定优先级的工作队列上。

Syntax

HRESULT MFPutWorkItemEx2(
  [in] DWORD          dwQueue,
  [in] LONG           Priority,
  [in] IMFAsyncResult *pResult
);

参数

[in] dwQueue

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

[in] Priority

工作项的优先级。 此值应为 1、0 或 -1。 值为 1 的项在值为 0 的项之前执行。 值为 -1 的项在值为 0 的项之后执行。

[in] pResult

指向异步结果对象的 IMFAsyncResult 接口的指针。 若要创建结果对象,请调用 MFCreateAsyncResult

返回值

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

返回代码 Description
S_OK
成功。
MF_E_INVALID_WORKQUEUE
无效的工作队列标识符。
MF_E_SHUTDOWN
未调用 MFStartup 函数,或调用 MFShutdown

注解

若要调用工作项,此函数会将 pResult 传递给 MFInvokeCallback 函数。 创建 由 pResult 指定的结果对象时,将指定回调。

要求

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

另请参阅

Media Foundation Functions

工作队列和线程处理改进

工作队列