IMediaControl-Schnittstelle (control.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 IMediaControl Schnittstelle stellt Methoden zum Steuern des Datenflusses durch das Filterdiagramm bereit. Sie enthält Methoden zum Ausführen, Anhalten und Beenden des Graphen. Der Filter Graph-Manager implementiert diese Schnittstelle. Weitere Informationen zu Filterdiagrammzuständen finden Sie unter Datenfluss im Filtergraph.
Vererbung
Die IMediaControl-Schnittstelle erbt von der IDispatch-Schnittstelle . IMediaControl verfügt auch über folgende Membertypen:
Methoden
Die IMediaControl-Schnittstelle verfügt über diese Methoden.
| IMediaControl::AddSourceFilter Die AddSourceFilter-Methode fügt dem Filterdiagramm einen Quellfilter hinzu. |
| IMediaControl::get_FilterCollection Die get_FilterCollection-Methode ruft eine Auflistung der Filter im Filtergraphen ab. |
| IMediaControl::get_RegFilterCollection Die get_RegFilterCollection-Methode ruft eine Auflistung aller in der Registrierung aufgeführten Filter ab. |
| IMediaControl::GetState Die GetState-Methode ruft den Status des angehaltenen, ausgeführten oder beendeten Filterdiagramms ab. |
| IMediaControl::P ause Die Pause-Methode hält alle Filter im Filterdiagramm an. |
| IMediaControl::RenderFile Die RenderFile-Methode erstellt ein Filterdiagramm, das die angegebene Datei rendert. (IMediaControl.RenderFile) |
| IMediaControl::Run Die Run-Methode führt alle Filter im Filtergraphen aus. Während der Ausführung des Graphen werden Daten durch das Diagramm verschoben und gerendert. |
| IMediaControl::Stop Die Stop-Methode beendet alle Filter im Diagramm. |
| IMediaControl::StopWhenReady Die StopWhenReady-Methode hält das Filterdiagramm an, sodass Filter Daten in die Warteschlange stellen können, und beendet dann den Filtergraphen. |
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 | control.h (include Dshow.h) |