IMFRealTimeClient interface

Notifies a pipeline object to register itself with the Multimedia Class Scheduler Service (MMCSS).

Any pipeline object that creates worker threads should implement this interface.

Members

The IMFRealTimeClient interface inherits from the IUnknown interface. IMFRealTimeClient also has these types of members:

Methods

The IMFRealTimeClient interface has these methods.

MethodDescription
RegisterThreads

Notifies the object to register its worker threads with MMCSS.

SetWorkQueue

Specifies the work queue for the topology branch to which this object belongs.

UnregisterThreads

Notifies the object to unregister its worker threads from MMCSS.

 

Remarks

Media Foundation provides a mechanism for applications to associate branches in the topology with MMCSS tasks. A topology branch is defined by a source node in the topology and all of the nodes downstream from it. An application registers a topology branch with MMCSS by setting the MF_TOPONODE_WORKQUEUE_ID attribute on the source node and then calling IMFWorkQueueServices::BeginRegisterTopologyWorkQueuesWithMMCSS.

When the application registers a topology branch with MMCSS, the Media Session queries every pipeline object in that branch for the IMFRealTimeClient interface. If the object exposes the interface, the Media Session calls RegisterThreads.

When the application unregisters the topology branch, the Media Session calls UnregisterThreads.

If a pipeline object creates its own worker threads but does not implement this interface, it can cause priority inversions in the Media Foundation pipeline, because high-priority processing threads might be blocked while waiting for the component to process data on a thread with lower priority.

Pipeline objects that do not create worker threads do not need to implement this interface.

In Windows 8, this interface is extended with IMFRealTimeClientEx.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Mfidl.h

Library

Mfuuid.lib

See also

Media Foundation Interfaces

 

 

Community Additions

ADD
Show:
© 2014 Microsoft