MFAllocateWorkQueue function (mfapi.h)

Creates a new work queue.

Syntax

HRESULT MFAllocateWorkQueue(
  [out] DWORD *pdwWorkQueue
);

Parameters

[out] pdwWorkQueue

Receives an identifier for the work queue.

Return value

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The function succeeded.
E_FAIL
The application exceeded the maximum number of work queues.
MF_E_SHUTDOWN
The application did not call MFStartup, or the application has already called MFShutdown.

Remarks

When you are done using the work queue, call MFUnlockWorkQueue.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header mfapi.h
Library Mfplat.lib
DLL Mfplat.dll

See also

MFPutWorkItem

MFPutWorkItemEx

Media Foundation Functions

Work Queues