Condividi tramite


EC_COMPLETE

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

È stato eseguito il rendering di tutti i dati di un flusso specifico.

Parametri

lParam1

(HRESULT) Stato del flusso al completamento. Se non si verificano errori durante la riproduzione, il valore viene S_OK.

lParam2

(IUnknown*) Zero o un puntatore all'interfaccia IBaseFilter del renderer.

Azione predefinita

Per impostazione predefinita, gestione graph del filtro non inoltra questo evento all'applicazione. Tuttavia, dopo che tutti i flussi nel report del grafo EC_COMPLETE, il gestore del grafo dei filtri invia un evento EC_COMPLETE separato all'applicazione.

Se l'azione predefinita è disabilitata per questo evento, l'applicazione riceve tutti gli eventi EC_COMPLETE dai renderer.

Commenti

Un filtro renderer invia questo evento quando riceve un avviso di fine flusso. La fine del flusso viene segnalata tramite il metodo IPin::EndOfStream . Il filtro invia esattamente un evento EC_COMPLETE per ogni flusso. Il filtro deve elaborare tutti gli esempi in sospeso prima di inviare l'evento. L'arresto di un renderer reimposta qualsiasi stato di fine flusso memorizzato nella cache.

Se il renderer viene sospeso, non invia EC_COMPLETE finché non viene chiamato il metodo IMediaFilter::Run . Inoltre, continua a inviare EC_COMPLETE eventi per ogni transizione da pausa a esecuzione, fino a quando il filtro non viene arrestato o scaricato.

I filtri impostano il parametro lParam2 su un puntatore IBaseFilter . Se l'azione predefinita è abilitata, la gestione del grafo del filtro imposta questo parametro su zero.

Requisiti

Requisito Valore
Intestazione
Dshow.h

Vedi anche

Codici di notifica degli eventi

Notifica degli eventi in DirectShow

Renderer video alternativi