Metodo CEnumMediaTypes.Next

[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 Next metodo recupera un numero specificato di tipi di supporti. Questo metodo implementa il metodo IEnumMediaTypes::Next .

Sintassi

HRESULT Next(
   ULONG         cMediaTypes,
   AM_MEDIA_TYPE **ppMediaTypes,
   ULONG         *pcFetched
);

Parametri

cMediaTypes

Numero di tipi di supporti da recuperare.

ppMediaTypes

Matrice di puntatori alle strutture AM_MEDIA_TYPE , di dimensioni cPins.

pcFetched

Puntatore a una variabile che riceve il numero di tipi multimediali restituiti dal metodo . Può essere NULL se cMediaTypes è 1.

Valore restituito

Restituisce uno dei valori HRESULT illustrati nella tabella seguente.

Codice restituito	Descrizione
S_FALSE	Non sono stati recuperati tutti i tipi di supporti richiesti.
S_OK	Operazione completata.
E_INVALIDARG	Argomento non valido.
E_POINTER	Argomento puntatore NULL.
VFW_E_ENUM_OUT_OF_SYNC	Lo stato del pin è cambiato ed è ora incoerente con l'enumeratore.

Commenti

Se il metodo ha esito positivo, la matrice specificata da ppMediaTypes contiene puntatori alle strutture AM_MEDIA_TYPE. Il numero di strutture è uguale a *pcFetched. Liberare ogni tipo di supporto chiamando la funzione DeleteMediaType .

Questo metodo chiama il metodo CBasePin::GetMediaType del pin per recuperare i tipi di supporto.

Requisiti

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

Vedi anche

Classe CEnumMediaTypes