CEnumMediaTypes-Klasse

[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 CEnumMediaTypes -Klasse implementiert einen Enumerator für bevorzugte Medientypen.

Diese Klasse implementiert die IEnumMediaTypes-Schnittstelle . Die folgenden CBasePin-Methoden werden aufgerufen:

• CBasePin::GetMediaType:Ruft einen Medientyp ab, auf den durch einen nullbasierten Index verwiesen wird.
• CBasePin::GetMediaTypeVersion: Bestimmt, ob sich die Gruppe der bevorzugten Typen geändert hat.

Wenn eine Pin die Liste der bevorzugten Medientypen ändert, erhöht die Pin die Versionsnummer des Medientyps. In diesem Fall wird das Enumeratorobjekt nicht mehr mit dem Pin synchronisiert, und die Klassenmethoden geben VFW_E_ENUM_OUT_OF_SYNC zurück. Rufen Sie die CEnumMediaTypes::Reset-Methode auf, um den Enumerator erneut zu synchronisieren.

Öffentliche Methoden	BESCHREIBUNG
CEnumMediaTypes	Konstruktormethode.
~CEnumMediaTypes	Destruktormethode. Virtuellen.
IEnumMediaTypes-Methoden	BESCHREIBUNG
Clone	Macht eine Kopie des Enumerators mit demselben Enumerationszustand.
Weiter	Ruft eine angegebene Anzahl von Medientypen ab.
Zurücksetzen	Setzt die Enumerationsfolge auf den Anfang zurück.
Überspringen	Überspringt eine angegebene Anzahl von Medientypen.

Anforderungen

Anforderung	Wert
Header	Amfilter.h (streams.h einschließen)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)