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)

Weitere Informationen

IDispatch