Export (0) Print
Expand All

IMFRealTimeClientEx::RegisterThreadsEx method

Notifies the object to register its worker threads with the Multimedia Class Scheduler Service (MMCSS).

Syntax


HRESULT RegisterThreadsEx(
  [in, out]  DWORD *pdwTaskIndex,
  [in]       LPCWSTR wszClassName,
  [in]       LONG lBasePriority
);

Parameters

pdwTaskIndex [in, out]

The MMCSS task identifier. If the value is zero on input, the object should create a new MCCSS task group. See Remarks.

wszClassName [in]

The name of the MMCSS task.

lBasePriority [in]

The base priority of the thread.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If the object does not create worker threads, the method should simply return S_OK and take no further action.

Otherwise, if the value of *pdwTaskIndex is zero on input, the object should perform the following steps:

  1. A single worker thread calls AvSetMmThreadCharacteristics to create a new MMCSS task identifier. Store this value.
  2. Any additional worker threads call AvSetMmThreadCharacteristics using the new task identifier.
  3. Return the new task identifier to the caller, by setting *pdwTaskIndex equal to the task identifier.

If the value of *pdwTaskIndex is nonzero on input, the parameter contains an existing MMCSS task identifer. In that case, all worker threads of the object should register themselves for that task by calling AvSetMmThreadCharacteristics.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

Mfidl.h

See also

Work Queue and Threading Improvements
IMFRealTimeClientEx

 

 

Community Additions

ADD
Show:
© 2014 Microsoft