IMFTopoLoader::Load-Methode (mfidl.h)

  • Artikel

Erstellt eine vollständig geladene Topologie aus der partiellen Topologie der Eingabe.

Syntax

HRESULT Load(
  [in]  IMFTopology *pInputTopo,
  [out] IMFTopology **ppOutputTopo,
  [in]  IMFTopology *pCurrentTopo
);

Parameter

[in] pInputTopo

Ein Zeiger auf die IMFTopology-Schnittstelle der zu auflösenden partiellen Topologie.

[out] ppOutputTopo

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

[in] pCurrentTopo

Ein Zeiger auf die IMFTopology-Schnittstelle der vorherigen vollständigen Topologie. Der Topologieladeprogramm kann Objekte aus dieser Topologie in der neuen Topologie wiederverwenden. Dieser Parameter kann NULL sein. Siehe Hinweise.

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_TOPO_SINK_ACTIVATES_UNSUPPORTED
 Mindestens ein Ausgabeknoten enthalten IMFActivate-Zeiger . Der Aufrufer muss die Ausgabeknoten an Mediensenken binden. Siehe Binden von Ausgabeknoten an Mediensenken.

Hinweise

Diese Methode erstellt alle zwischengeschalteten Transformationen, die zum Abschließen der Topologie erforderlich sind. Außerdem werden die Eingabe- und Ausgabemedientypen für alle Objekte in der Topologie festgelegt. Wenn die Methode erfolgreich ist, wird die vollständige Topologie im ppOutputTopo-Parameter zurückgegeben.

Sie können den pCurrentTopo-Parameter verwenden, um eine vollständige Topologie bereitzustellen, die zuvor geladen wurde. Wenn diese Topologie Objekte enthält, die in der neuen Topologie benötigt werden, kann der Topologieladeprogramm diese erneut verwenden, ohne sie erneut zu erstellen. Diese Zwischenspeicherung kann den Prozess möglicherweise beschleunigen. Die Objekte aus pCurrentTopo werden nicht neu konfiguriert, sodass Sie eine Topologie angeben können, die aktiv Daten streamt. Während beispielsweise eine Topologie noch ausgeführt wird, können Sie die nächste Topologie vorab laden.

Vor dem Aufrufen dieser Methode müssen Sie sicherstellen, dass die Ausgabeknoten in der partiellen Topologie über gültige IMFStreamSink-Zeiger und nicht über IMFActivate-Zeiger verfügen. Die Mediensitzung führt diese Aktion automatisch innerhalb der IMFMediaSession::SetTopology-Methode aus. Wenn Sie jedoch Load aufrufen, bevor Sie SetTopology aufrufen, müssen Sie die Ausgabeknoten manuell binden. Weitere Informationen finden Sie unter Binden von Ausgabeknoten an Mediensenken.

Anforderungen

   
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

Erweiterte Topologieerstellung

IMFTopoLoader

Topologien