IEnumMediaTypes-Schnittstelle (strmif.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 IEnumMediaTypes-Schnittstelle listet die bevorzugten Medientypen einer Pin auf. Um diese Schnittstelle zu erhalten, rufen Sie die IPin::EnumMediaTypes-Methode auf der Pin auf. Filter verwenden diese Schnittstelle, wenn sie eine Verbindung mit anderen Filtern herstellen. Anwendungen können sie auch verwenden, um die bevorzugten Medientypen einer Pin zu untersuchen. Weitere Informationen finden Sie unter Auflisten von Objekten in einem Filtergraphen.
Diese Schnittstelle implementiert ein standardmäßiges COM-Auflistungsobjekt (Component Object Model).
Wenn sich der Satz der bevorzugten Medientypen einer Pin ändert, geben einige Methoden auf dieser Schnittstelle VFW_E_ENUM_OUT_OF_SYNC zurück. Rufen Sie die IEnumMediaTypes::Reset-Methode auf, um den Enumerator erneut zu synchronisieren.
Vererbung
Die IEnumMediaTypes-Schnittstelle erbt von der IUnknown-Schnittstelle . IEnumMediaTypes verfügt auch über folgende Membertypen:
Methoden
Die IEnumMediaTypes-Schnittstelle verfügt über diese Methoden.
| IEnumMediaTypes::Clone Die Clone-Methode stellt eine Kopie des Enumerators her. Das zurückgegebene Objekt beginnt mit demselben Enumerationszustand wie das Original. |
| IEnumMediaTypes::Next Die Next-Methode ruft eine angegebene Anzahl von Medientypen ab. |
| IEnumMediaTypes::Reset Die Reset-Methode setzt die Enumerationssequenz an den Anfang zurück. (IEnumMediaTypes.Reset) |
| IEnumMediaTypes::Skip Die Skip-Methode überspringt eine angegebene Anzahl von Medientypen. |
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 | strmif.h (include Dshow.h) |