Freigeben über


IMediaFilter-Schnittstelle (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die IMediaFilter Schnittstelle steuert den Streamingstatus eines Filters.

Alle DirectShow-Filter implementieren diese Schnittstelle. Es bietet Methoden zum Wechseln des Filters zwischen Zuständen (beendet, angehalten und ausgeführt). zum Abrufen des aktuellen Status des Filters; und zum Festlegen einer Referenzuhr. Anwendungen sollten keine Methoden für Filter aufrufen IMediaFilter .

Der Filter Graph-Manager macht diese Schnittstelle auch verfügbar. Anwendungen können die SetSyncSource-Methode zum Festlegen der Graph-Referenzuhr und GetSyncSource zum Abrufen der Uhr verwenden. Anwendungen sollten die anderen Methoden auf dieser Schnittstelle nicht aufrufen. Verwenden Sie stattdessen die entsprechenden Methoden für die IMediaControl-Schnittstelle .

Die IBaseFilter-Schnittstelle erbt von IMediaFilter.

Vererbung

Die IMediaFilter-Schnittstelle erbt von IPersist. IMediaFilter verfügt auch über folgende Arten von Membern:

Methoden

Die IMediaFilter-Schnittstelle verfügt über diese Methoden.

 
IMediaFilter::GetState

Die GetState-Methode ruft den Status des Filters ab (wird ausgeführt, beendet oder angehalten).
IMediaFilter::GetSyncSource

Die GetSyncSource-Methode ruft die aktuelle Referenzuhr ab.
IMediaFilter::P ause

Die Pause-Methode hält den Filter an.
IMediaFilter::Run

Die Run-Methode führt den Filter aus.
IMediaFilter::SetSyncSource

Die SetSyncSource-Methode legt die Referenzuhr fest.
IMediaFilter::Stop

Die Stop-Methode beendet den Filter.

Anforderungen

   
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)