Export (0) Print
Expand All

IMFMediaSession::ClearTopologies method

Clears all of the presentations that are queued for playback in the Media Session.

Syntax


HRESULT ClearTopologies();

Parameters

This method has no parameters.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return codeDescription
S_OK

The method succeeded.

MF_E_INVALIDREQUEST

The operation cannot be performed in the Media Session's current state.

MF_E_SHUTDOWN

The Media Session has been shut down.

 

Remarks

This method is asynchronous. When the operation completes, the Media Session sends an MESessionTopologiesCleared event.

This method does not clear the current topology; it only removes topologies that are placed in the queue, waiting for playback. To remove the current topology, call IMFMediaSession::SetTopology with the MFSESSION_SETTOPOLOGY_CLEAR_CURRENT flag.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Mfidl.h

Library

Mfuuid.lib

See also

IMFMediaSession

 

 

Community Additions

ADD
Show:
© 2014 Microsoft