IFilterGraph-Schnittstelle (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 IFilterGraph -Schnittstelle stellt Methoden zum Erstellen eines Filterdiagramms bereit. Eine Anwendung kann sie verwenden, um dem Diagramm Filter hinzuzufügen, Filter zu verbinden oder zu trennen, Filter zu entfernen und andere grundlegende Vorgänge auszuführen. Die IGraphBuilder-Schnittstelle erbt jedoch von dieser Schnittstelle und stellt zusätzliche Methoden bereit, die komplexer sind. Daher sollten Anwendungen IGraphBuilder anstelle der direkten Verwendung IFilterGraph verwenden.
Der Filtergraph-Manager implementiert diese Schnittstelle.
Vererbung
Die IFilterGraph-Schnittstelle erbt von der IUnknown-Schnittstelle . IFilterGraph verfügt auch über folgende Membertypen:
Methoden
Die IFilterGraph-Schnittstelle verfügt über diese Methoden.
| IFilterGraph::AddFilter Die AddFilter-Methode fügt dem Diagramm einen Filter hinzu. |
| IFilterGraph::ConnectDirect Die ConnectDirect-Methode verbindet die beiden Pins direkt (ohne dazwischen liegende Filter). |
| IFilterGraph::D isconnect Die Disconnect-Methode trennt diesen Pin. |
| IFilterGraph::EnumFilters Die EnumFilters-Methode stellt einen Enumerator für alle Filter im Diagramm bereit. |
| IFilterGraph::FindFilterByName Die FindFilterByName-Methode findet einen Filter, der dem Filterdiagramm mit einem bestimmten Namen hinzugefügt wurde. |
| IFilterGraph::Reconnect Die Reconnect-Methode trennt einen Pin und verbindet ihn dann erneut mit demselben Pin. |
| IFilterGraph::RemoveFilter Die RemoveFilter-Methode entfernt einen Filter aus dem Diagramm. |
| IFilterGraph::SetDefaultSyncSource Die SetDefaultSyncSource-Methode legt die Referenzuhr auf die Standarduhr fest. |
Anforderungen
| Anforderung | Wert |
|---|---|
| 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) |