MFPutWorkItemEx2 function (mfapi.h)
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
[in] dwQueue
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.
[in] Priority
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.
[in] pResult
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 |
|---|---|
|
Success. |
|
Invalid work queue identifier. |
|
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2012 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | mfapi.h |
| Library | Mfplat.lib |
| DLL | Mfplat.dll |