IMFMediaSession::GetFullTopology-Methode (mfidl.h)

  • Artikel

Ruft eine Topologie aus der Mediensitzung ab.

Diese Methode kann die aktuelle Topologie oder eine Topologie mit Warteschlange abrufen.

Syntax

HRESULT GetFullTopology(
  [in]  DWORD       dwGetFullTopologyFlags,
  [in]  TOPOID      TopoId,
  [out] IMFTopology **ppFullTopology
);

Parameter

[in] dwGetFullTopologyFlags

Bitweise OR mit null oder mehr Flags aus der MFSESSION_GETFULLTOPOLOGY_FLAGS-Enumeration .

[in] TopoId

Der Bezeichner der Topologie. Dieser Parameter wird ignoriert, wenn der dwGetFullTopologyFlags-Parameter das flag MFSESSION_GETFULLTOPOLOGY_CURRENT enthält. Um den Bezeichner einer Topologie abzurufen, rufen Sie IMFTopology::GetTopologyID auf.

[out] ppFullTopology

Empfängt einen Zeiger auf die IMFTopology-Schnittstelle der Topologie. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_SHUTDOWN
 Die Mediensitzung wurde heruntergefahren.

Hinweise

Wenn das flag MFSESSION_GETFULLTOPOLOGY_CURRENT im dwGetFullTopologyFlags-Parameter angegeben ist, gibt die Methode die Topologie für die aktuelle Präsentation zurück. Andernfalls durchsucht die -Methode alle in der Warteschlange befindlichen Topologien nach einer Topologie, die dem im TopoId-Parameter angegebenen Bezeichner entspricht.

Diese Methode kann verwendet werden, um die Topologie für die aktuelle Präsentation oder alle ausstehenden Präsentationen abzurufen. Es kann nicht verwendet werden, um eine Topologie abzurufen, die bereits beendet wurde.

Die in ppFullTopo zurückgegebene Topologie ist eine vollständige Topologie, keine partielle Topologie.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFMediaSession

TOPOID