Classe CEnumMediaTypes

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

La CEnumMediaTypes classe implementa un enumeratore per i tipi di supporti preferiti.

Questa classe implementa l'interfaccia IEnumMediaTypes . Chiama i metodi CBasePin seguenti:

• CBasePin::GetMediaType:Recupera un tipo di supporto, a cui fa riferimento un indice in base zero.
• CBasePin::GetMediaTypeVersion: determina se il set di tipi preferiti è stato modificato.

Ogni volta che un pin modifica l'elenco di tipi di supporti preferiti, il pin incrementa il numero di versione del tipo di supporto. In questo caso, l'oggetto enumeratore non è più sincronizzato con il pin e i metodi della classe restituiscono VFW_E_ENUM_OUT_OF_SYNC. Chiamare il metodo CEnumMediaTypes::Reset per risincronizzare l'enumeratore.

Metodi pubblici	Descrizione
CEnumMediaTypes	Metodo del costruttore.
~CEnumMediaTypes	Metodo distruttore. Virtuale.
Metodi IEnumMediaTypes	Descrizione
Clone	Crea una copia dell'enumeratore con lo stesso stato di enumerazione.
Avanti	Recupera un numero specificato di tipi di supporti.
Reimpostazione	Riporta all'inizio la sequenza di enumerazione.
Ignora	Ignora un numero specificato di tipi di supporti.

Requisiti

Requisito	Valore
Intestazione	Amfilter.h (include Streams.h)
Libreria	Strmbase.lib (build retail); Strmbasd.lib (build di debug)