Método CEnumMediaTypes.Next
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El Next método recupera un número especificado de tipos de medios. Este método implementa el método IEnumMediaTypes::Next .
Sintaxis
HRESULT Next(
ULONG cMediaTypes,
AM_MEDIA_TYPE **ppMediaTypes,
ULONG *pcFetched
);
Parámetros
-
cMediaTypes
-
Número de tipos de medios que se van a recuperar.
-
ppMediaTypes
-
Matriz de punteros a AM_MEDIA_TYPE estructuras, de tamaño cPins.
-
pcFetched
-
Puntero a una variable que recibe el número de tipos multimedia devueltos por el método. Puede ser NULL si cMediaTypes es 1.
Valor devuelto
Devuelve uno de los valores HRESULT que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
No recuperó tantos tipos de medios como se solicitó. |
|
Correcto. |
|
Argumento no válido. |
|
Argumento de puntero NULL. |
|
El estado del pin ha cambiado y ahora es incoherente con el enumerador. |
Observaciones
Si el método se realiza correctamente, la matriz especificada por ppMediaTypes contiene punteros a AM_MEDIA_TYPE estructuras. El número de estructuras es igual a *pcFetched. Libere cada tipo de medio llamando a la función DeleteMediaType .
Este método llama al método CBasePin::GetMediaType del pin para recuperar los tipos multimedia.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|