MF_SESSION_TOPOLOADER attribute

Contains the CLSID of a topology loader for the Media Session.

Data type

GUID

Remarks

You can use this attribute to provide a custom topology loader for the Media Session.

Set this attribute using the pConfiguration parameter of the MFCreateMediaSession function or the MFCreatePMPMediaSession function.

If this attribute is set, the Media Session calls CoCreateInstance with the specified CLSID when it creates the topology loader. The object created by this CLSID must expose the IMFTopoLoader interface.

If this attribute is not set, the Media Session creates the default topology loader provided in Media Foundation.

A topology loader must support multithreaded apartments. You should register the topology loader as ThreadingModel="Both". Also, if you are using the topology loader inside the protected media path (PMP), the topology loader must be a trusted component. For more information, see Protected Media Path.

The GUID constant for this attribute is exported from mfuuid.lib.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Mfidl.h

See also

Alphabetical List of Media Foundation Attributes
IMFAttributes::GetGUID
IMFAttributes::SetGUID
Media Session Attributes
Custom Topology Loaders

 

 

Show: