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