Metodo CEnumPins.Next

  • Articolo

[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.

Il metodo Next recupera un numero specificato di pin nella sequenza di enumerazione. Questo metodo implementa il metodo IEnumPins::Next .

Sintassi

HRESULT Next(
   ULONG cPins,
   IPin  **ppPins,
   ULONG *pcFetched
);

Parametri

cPins

Numero di pin da recuperare.

ppPins

Matrice di puntini di misura riempiti con puntatoriIPin .

pcFetched

Puntatore a una variabile che riceve il numero di pin recuperati. Può essere NULL se cPins è 1.

Valore restituito

Restituisce uno dei valori HRESULT illustrati nella tabella seguente.

Codice restituito Descrizione
S_FALSE
 Non è stato recuperato il numero di pin richiesti.
S_OK
 Operazione completata.
E_INVALIDARG
 Argomento non valido.
E_POINTER
 Argomento puntatore NULL.
VFW_E_ENUM_OUT_OF_SYNC
 Lo stato del filtro è stato modificato ed è ora incoerente con l'enumeratore.

Commenti

Questo metodo recupera i puntatori al numero specificato di pin, a partire dalla posizione corrente nell'enumerazione e li inserisce nella matrice specificata.

Questo metodo chiama il metodo CBaseFilter::GetPin del filtro per recuperare i pin.

Se il metodo ha esito positivo, i puntatori IPin hanno tutti conteggi dei riferimenti in sospeso. Al termine, assicurarsi di rilasciarli.

Requisiti

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

Vedi anche

Classe CEnumPins