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) |