Método CEnumPins.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 método Next recupera un número especificado de patillas en la secuencia de enumeración. Este método implementa el método IEnumPins::Next .

Sintaxis

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

Parámetros

cPins

Número de patillas que se van a recuperar.

ppPins

Matriz de cPins de tamaño que se rellena con punteros IPin .

pcFetched

Puntero a una variable que recibe el número de patillas recuperadas. Puede ser NULL si cPins es 1.

Valor devuelto

Devuelve uno de los valores HRESULT que se muestran en la tabla siguiente.

Código devuelto	Descripción
S_FALSE	No recuperó tantas patillas como se solicitó.
S_OK	Correcto.
E_INVALIDARG	Argumento no válido.
E_POINTER	Argumento de puntero NULL.
VFW_E_ENUM_OUT_OF_SYNC	El estado del filtro ha cambiado y ahora es incoherente con el enumerador.

Observaciones

Este método recupera punteros al número especificado de patillas, comenzando en la posición actual de la enumeración y los coloca en la matriz especificada.

Este método llama al método CBaseFilter::GetPin del filtro para recuperar las patillas.

Si el método se realiza correctamente, todos los punteros IPin tienen recuentos de referencia pendientes. Asegúrese de liberarlos cuando haya terminado.

Requisitos

Requisito	Value
Encabezado	Amfilter.h (include Streams.h)
Biblioteca	Strmbase.lib (compilaciones comerciales); Strmbasd.lib (compilaciones de depuración)

Consulte también

CEnumPins (clase)