MFPutWorkItemEx2 函数 (mfapi.h)

  • 项目

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

语法

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

parameters

[in] dwQueue

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

[in] Priority

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

[in] pResult

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

返回值

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

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

注解

为了调用工作项，此函数将 pResult 传递给 MFInvokeCallback 函数。 回调是在创建 由 pResult 指定的结果对象时指定的。

要求

   
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

另请参阅

媒体基础函数

工作队列和线程处理改进

工作队列