MF_TOPONODE_NOSHUTDOWN_ON_REMOVE attribute

Specifies how the Media Session shuts down an object in the topology.

Data type

UINT32

Treat as a Boolean value.

Remarks

This attribute applies to the following types of topology node:

• Output nodes
• Any transform node that contains an asynchronous Media Foundation transform (MFT).

The attribute can have the following values:

Value	Description
TRUE	When the Media Session switches to a new topology or clears the current topology, it does not shut down the object that belongs to this topology node.
FALSE	When the Media Session switches to a new topology or clears the current topology, it shuts down the node object, as follows: Output nodes: The session calls IMFMediaSink::Shutdown on the media sink. Transform nodes: The session calls IMFShutdown::Shutdown on the MFT.

 

The default value is TRUE.

If your application queues multiple topologies, it is a good idea to set this attribute to FALSE. Otherwise, objects in the topology might not be shut down correctly.

This attribute does not apply when the application shuts down the Media Session by calling IMFMediaSession::Shutdown. When the Media Session shuts down, it always shuts down the media sinks and asynchronous MFTs in the current topology.

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

Asynchronous MFTs

Topology Node Attributes

IMFAttributes::GetUINT32

IMFAttributes::SetUINT32

IMFTopologyNode