Export (0) Print
Expand All
Expand Minimize

MFGetWorkQueueMMCSSClass function

Retrieves the Multimedia Class Scheduler Service (MMCSS) class currently associated with this work queue.

Syntax


HRESULT MFGetWorkQueueMMCSSClass(
  _In_     DWORD dwWorkQueueId,
  _Out_    LPWSTR pwszClass,
  _Inout_  DWORD *pcchClass
);

Parameters

dwWorkQueueId [in]

Identifier for the work queue. The identifier is retrieved by the MFAllocateWorkQueue function.

pwszClass [out]

Pointer to a buffer that receives the name of the MMCSS class. This parameter can be NULL.

pcchClass [in, out]

On input, specifies the size of the pwszClass buffer, in characters. On output, receives the required size of the buffer, in characters. The size includes the terminating null character.

Return value

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

Return codeDescription
S_OK

The function succeeded.

MF_E_BUFFERTOOSMALL

The pwszClass buffer is too small to receive the task name.

 

Remarks

If the work queue is not associated with an MMCSS task, the function retrieves an empty string.

To associate a work queue with an MMCSS task, call MFBeginRegisterWorkQueueWithMMCSS.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Mfapi.h

Library

Mfplat.lib

DLL

Mfplat.dll

See also

Media Foundation Functions
Work Queues

 

 

Community Additions

ADD
Show:
© 2014 Microsoft