MFPutWorkItem2

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

Syntax

HRESULT MFPutWorkItem2(
         DWORD dwQueue,
         LONG Priority,
         IMFAsyncCallback *pCallback,
         IUnknown *pState
)

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.

pCallback
Type: IMFAsyncCallback *

[in] A pointer to the IMFAsyncCallback interface. The caller must implement this interface.

pState
Type: IUnknown *

[in, optional] A pointer to the IUnknown interface of a state object, defined by the caller. This parameter can be NULL. You can use this object to hold state information. The object is returned to the caller when the callback is invoked.

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.

Requirements

Header: Declared in mfapi.h.

Library: Use mfplat.lib.