Método CBaseRenderer.PrepareReceive

El PrepareReceive método prepara el filtro para representar un ejemplo.

Sintaxis

virtual HRESULT PrepareReceive(
   IMediaSample *pMediaSample
);

Parámetros

pMediaSample

Puntero a la interfaz IMediaSample del ejemplo.

Valor devuelto

Devuelve un valor HRESULT. Los valores posibles incluyen los de la tabla siguiente.

Código devuelto Descripción
S _ OK
Correcto.
E _ FAIL
Failed.
E _ UNEXPECTED
error inesperado.
EJEMPLO DE VFW _ E _ _ RECHAZADO
El filtro quita este ejemplo.

Observaciones

El filtro llama a este método desde dentro del método CBaseRenderer::Receive, antes de representar un ejemplo. Si el filtro se está ejecutando, este método programa el ejemplo para su representación.

Si el filtro ya tiene un ejemplo pendiente o si ya se ha alcanzado el final de la secuencia, el método devuelve E _ UNEXPECTED. Posiblemente, el filtro ascendente no serializa correctamente sus llamadas de streaming.

Si el algoritmo de programación determina que se debe eliminar el ejemplo (vea CBaseRenderer::ScheduleSample),el método devuelve VFW _ E SAMPLE _ _ REJECTED. Sin embargo, el método IMemInputPin::Receive del pin de entrada no pasa este código de error al filtro ascendente, porque quitar un ejemplo no es un error.

Requisitos

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

Vea también

CBaseRenderer (clase)