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