IMFMediaSession::GetFullTopology-Methode (mfidl.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |