MFPutWorkItemEx2

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

Syntax

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

Parameters

dwQueue
Type: DWORD

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
Type: LONG

The priority of the work item. Work items are performed in order of priority.

pResult
Type: IMFAsyncResult *

[in] A pointer to the IMFAsyncResult interface of an asynchronous result object. To create the result object, call MFCreateAsyncResult.

Return value

Type: HRESULT

Returns an HRESULT value. Possible values include the following.

Return codes

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.

Refer to Media Foundation return codes.

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

Header: Declared in mfapi.h.

Library: Use mfplat.lib.