Classe CEnumPins

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

La CEnumPins classe implementa un enumeratore per i pin.

Questa classe implementa l'interfaccia IEnumPins . Chiama i metodi CBaseFilter seguenti:

• CBaseFilter::GetPin: recupera un pin nel filtro, a cui fa riferimento un indice in base zero.
• CBaseFilter::GetPinCount: recupera il numero totale di pin nel filtro.
• CBaseFilter::GetPinVersion: determina se i pin sono stati modificati.

Se il filtro crea o elimina dinamicamente i pin, incrementa la versione del pin ogni volta che cambiano i pin. Se il numero di versione cambia, l'oggetto enumeratore non è più sincronizzato con il filtro. Dopo che l'enumeratore non è sincronizzato, i metodi in CEnumPins ritorno VFW_E_ENUM_OUT_OF_SYNC. Chiamare il metodo CEnumPins::Reset per risincronizzare l'enumeratore.

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

Requisiti

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