Export (0) Print
Expand All
Expand Minimize

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 toplogy node:

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

The attribute can have the following values:

ValueDescription
TRUEWhen 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.
FALSEWhen 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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Mfidl.h

See also

Asynchronous MFTs
Topology Node Attributes
IMFAttributes::GetUINT32
IMFAttributes::SetUINT32
IMFTopologyNode

 

 

Community Additions

ADD
Show:
© 2014 Microsoft