MFSESSION_SETTOPOLOGY_FLAGS enumeration (mfidl.h)

  • Article

Defines the behavior of the IMFMediaSession::SetTopology method.

Syntax

typedef enum MFSESSION_SETTOPOLOGY_FLAGS {
  MFSESSION_SETTOPOLOGY_IMMEDIATE = 0x1,
  MFSESSION_SETTOPOLOGY_NORESOLUTION = 0x2,
  MFSESSION_SETTOPOLOGY_CLEAR_CURRENT = 0x4
} ;

Constants

 
MFSESSION_SETTOPOLOGY_IMMEDIATE
Value: 0x1
Stop the current presentation, clear all pending presentations, and immediately queue the new topology (specified by the pTopology parameter).

If the pTopology parameter is NULL, this flag has no effect.
MFSESSION_SETTOPOLOGY_NORESOLUTION
Value: 0x2
The topology does not need to be resolved. Use this flag if you are setting a full topology.
MFSESSION_SETTOPOLOGY_CLEAR_CURRENT
Value: 0x4
Note  Requires Windows 7.

 

Clear the current topology, as follows:


  • If pTopology is not NULL, the topology is cleared only if pTopology matches the current topology (that is, only if pTopology points to the current topology).

  • If the pTopology parameter is NULL, the current topology is cleared, regardless of which topology is current.


Pending topologies are not removed from the playback queue. If there is a pending topology on the queue, that topology will be loaded after the current topology is cleared. Otherwise, playback simply stops.

To remove all of the pending topologies from the queue, call IMFMediaSession::ClearTopologies.

Remarks

These flags are optional, and are not mutually exclusive. If no flags are set, the Media Session resolves the topology and then adds it to the queue of pending presentations.

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

Media Foundation Enumerations