Partilhar via


EC_COMPLETE

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Todos os dados de um fluxo específico foram renderizados.

Parâmetros

Lparam1

(HRESULT) Status do fluxo após a conclusão. Se nenhum erro tiver ocorrido durante a reprodução, o valor será S_OK.

lParam2

(IUnknown*) Zero ou um ponteiro para a interface IBaseFilter do renderizador.

Ação Padrão

Por padrão, o gerenciador de grafo de filtro não encaminha esse evento para o aplicativo. No entanto, depois que todos os fluxos no relatório de grafo EC_COMPLETE, o gerenciador de grafo de filtro posta um evento EC_COMPLETE separado no aplicativo.

Se a ação padrão estiver desabilitada para esse evento, o aplicativo receberá todos os eventos EC_COMPLETE dos renderizadores.

Comentários

Um filtro de renderizador envia esse evento quando recebe um aviso de fim de fluxo. (O fim do fluxo é sinalizado por meio do método IPin::EndOfStream .) O filtro envia exatamente um evento EC_COMPLETE para cada fluxo. O filtro deve processar todos os exemplos pendentes antes de enviar o evento. Parar um renderizador redefine qualquer estado de fim de fluxo que foi armazenado em cache.

Se o renderizador estiver em pausa, ele não enviará EC_COMPLETE até que o método IMediaFilter::Run seja chamado. Além disso, ele continua a enviar EC_COMPLETE eventos para cada transição de pausa para execução, até que o filtro seja interrompido ou liberado.

Os filtros definem o parâmetro lParam2 como um ponteiro IBaseFilter . Se a ação padrão estiver habilitada, o gerenciador de grafo de filtro definirá esse parâmetro como zero.

Requisitos

Requisito Valor
parâmetro
Dshow.h

Confira também

Códigos de notificação de evento

Notificação de eventos no DirectShow

Renderizadores de vídeo alternativos