Método CPullPin.Receive

Artículo
07/28/2023

[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.

Se Receive llama al método cuando el objeto recibe una muestra multimedia del pin de salida. La clase derivada debe implementar este método.

Sintaxis

virtual HRESULT Receive(
   IMediaSample *pSample
) = 0;

Parámetros

pSample: Puntero a la interfaz IMediaSample del ejemplo multimedia.

Valor devuelto

Devuelve un valor HRESULT . Devolver un valor distinto de S_OK detendrá el subproceso de extracción de datos.

Observaciones

Se llama a este método cada vez que llega un nuevo ejemplo desde el pin de salida. Escriba este método de la misma manera que el método IMemInputPin::Receive .

Las marcas de tiempo del ejemplo especifican los desplazamientos de bytes, en relación con la posición inicial original especificada en el método CPullPin::Seek .

La posición inicial se redondea hacia abajo hasta el límite de alineación más cercano y la posición de detención se redondea hacia arriba hasta el límite de alineación más cercano. Además, si la posición de detención supera la duración total, la duración se usa en su lugar.

Todas las marcas de tiempo se proporcionan como un desplazamiento de bytes multiplicado por 10 000 000, definidos como unidades constantes. Por lo tanto, no es decir, un segundo es un byte. Para buscar los desplazamientos de bytes reales, llame a IMediaSample::GetTime y divida los resultados por UNITS.

Requisitos

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

Consulte también

CPullPin (clase)