Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
MFSESSION_SETTOPOLOGY_FLAGS
Collapse the table of content
Expand the table of content

MFSESSION_SETTOPOLOGY_FLAGS enumeration

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
} MFSESSION_SETTOPOLOGY_FLAGS;

Constants

MFSESSION_SETTOPOLOGY_IMMEDIATE

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

The topology does not need to be resolved. Use this flag if you are setting a full topology.

MFSESSION_SETTOPOLOGY_CLEAR_CURRENT
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

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

 

 

Community Additions

ADD
Show:
© 2015 Microsoft