Freigeben über


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