MFPutWorkItemEx2 function

Puts an asynchronous operation on a work queue, with a specified priority.

Syntax


HRESULT MFPutWorkItemEx2(
  _In_ DWORD          dwQueue,
  _In_ LONG           Priority,
  _In_ IMFAsyncResult *pResult
);

Parameters

dwQueue [in]: The identifier for the work queue. This value can specify one of the standard Media Foundation work queues, or a work queue created by the application. For list of standard Media Foundation work queues, see Work Queue Identifiers. To create a new work queue, call MFAllocateWorkQueue or MFAllocateWorkQueueEx.
Priority [in]: The priority of the work item. This value should be 1, 0, or -1. Items with a value of 1 are executed before items with a value of 0. Items with a value of -1 are executed after items with a value of 0.
pResult [in]: A pointer to the IMFAsyncResult interface of an asynchronous result object. To create the result object, call MFCreateAsyncResult.

Return value

Returns an HRESULT value. Possible values include the following.

Return code	Description
S_OK	Success.
MF_E_INVALID_WORKQUEUE	Invalid work queue identifier.
MF_E_SHUTDOWN	The MFStartup function was not called, or MFShutdown was called.

Remarks

To invoke the work item, this function passes pResult to the MFInvokeCallback function. The callback is specified when you create the result object specified by pResult.

Requirements

Minimum supported client	Windows 8 [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2012 [desktop apps \| Windows Store apps]
Minimum supported phone	Windows Phone 8.1
Header	Mfapi.h
Library	Mfplat.lib
DLL	Mfplat.dll