Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |