Método COutputQueue.ReceiveMultiple

  • Artículo

[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 ReceiveMultiple método entrega un lote de muestras multimedia al pin de entrada.

Sintaxis

HRESULT ReceiveMultiple(
   IMediaSample **ppSamples,
   long         nSamples,
   long         *nSamplesProcessed
);

Parámetros

ppSamples

Dirección de un puntero a una matriz de ejemplos.

nSamples

Número de muestras de la matriz.

nSamplesProcessed

Puntero a una variable que recibe el número de muestras entregadas correctamente.

Valor devuelto

Devuelve un valor HRESULT . Entre los valores posibles se incluyen los que se muestran en la tabla siguiente.

Código devuelto Descripción
S_FALSE
 Notificación de fin de secuencia recibida antes de procesar este ejemplo.
S_OK
 Correcto.

Observaciones

Si el objeto usa un subproceso, este método pone en cola todos los ejemplos pasados en la matriz. De lo contrario, el método llama al método IMemInputPin::ReceiveMultiple en el pin de entrada.

Requisitos

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

Consulte también

COutputQueue (clase)