EC_COMPLETE

[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 han representado todos los datos de una secuencia determinada.

Parámetros

lParam1

(HRESULT) Estado de la secuencia al finalizar. Si no se produjo ningún error durante la reproducción, el valor es S_OK.

lParam2

(IUnknown*) Cero, o un puntero a la interfaz IBaseFilter del representador.

Acción predeterminada

De forma predeterminada, el administrador de gráficos de filtros no reenvía este evento a la aplicación. Sin embargo, después de todas las secuencias del informe de grafos EC_COMPLETE, el administrador de gráficos de filtros publica un evento de EC_COMPLETE independiente en la aplicación.

Si la acción predeterminada está deshabilitada para este evento, la aplicación recibe todos los eventos de EC_COMPLETE de los representadores.

Observaciones

Un filtro de representador envía este evento cuando recibe un aviso de fin de secuencia. (El final de la secuencia se señala a través del método IPin::EndOfStream ). El filtro envía exactamente un evento EC_COMPLETE para cada secuencia. El filtro debe procesar los ejemplos pendientes antes de enviar el evento. Al detener un representador, se restablece cualquier estado de fin de flujo almacenado en caché.

Si el representador está en pausa, no envía EC_COMPLETE hasta que se llame al método IMediaFilter::Run . Además, continúa enviando eventos EC_COMPLETE para cada transición de pausa a ejecución, hasta que el filtro se detenga o se vacíe.

Los filtros establecen el parámetro lParam2 en un puntero IBaseFilter . Si la acción predeterminada está habilitada, el administrador de gráficos de filtros establece este parámetro en cero.

Requisitos

Requisito Value
Encabezado
Dshow.h

Consulte también

Códigos de notificación de eventos

Notificación de eventos en DirectShow

Representadores de vídeo alternativos