IStreamBuilder::Backout-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die Backout
-Methode hebt die in der IStreamBuilder::Render-Methode ausgeführten Schritte auf. Dies umfasst das Trennen und Entfernen aller Filter, die in Render hinzugefügt wurden.
HRESULT Backout(
[in] IPin *ppinOut,
[in] IGraphBuilder *pGraph
);
[in] ppinOut
Zeiger auf die IPin-Schnittstelle dieses Pins.
[in] pGraph
Zeiger auf die IGraphBuilder-Schnittstelle des Filter Graph-Managers.
Gibt einen HRESULT-Wert zurück. Ein Rückgabecode von S_OK gibt dem Graph-Generator an, dass die Trennung erfolgreich war.
Das folgende Beispiel zeigt, wie ein Filter die Schritte umkehren würde, die im Codebeispiel für die IStreamBuilder::Render-Methode gezeigt werden:
C++ |
---|
|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | strmif.h (include Dshow.h) |
Bibliothek | Strmiids.lib |