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:
|
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 |
|
See also