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

Requirement Value
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