MFSESSION_SETTOPOLOGY_FLAGS enumeration (mfidl.h)

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