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 |
|---|---|
|
Non sono stati recuperati tutti i tipi di supporti richiesti. |
|
Operazione completata. |
|
Argomento non valido. |
|
Argomento puntatore NULL. |
|
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 |
|
| Libreria |
|