Expand Minimize

MFPutWorkItem2 function

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

Syntax


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

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. Work items are performed in order of priority.

pCallback [in]

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

pState [in]

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

Returns an HRESULT value. Possible values include the following.

Return codeDescription
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

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

Mfapi.h

Library

Mfplat.lib

DLL

Mfplat.dll

See also

Work Queues
Work Queue and Threading Improvements

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.