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 |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für