EC_COMPLETE

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayerIMFMediaEngine音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

已轉譯來自特定資料流程的所有資料。

參數

lParam1

(HRESULT) 完成時資料流程的狀態。 如果播放期間未發生任何錯誤,值就會S_OK。

lParam2

(IUnknown*) Zero,或轉譯 器的 IBaseFilter 介面指標。

預設動作

根據預設,篩選圖形管理員不會將此事件轉送至應用程式。 不過,在圖表報表中的所有資料流程 EC_COMPLETE之後,篩選圖表管理員會將個別 的EC_COMPLETE 事件張貼至應用程式。

如果停用此事件的預設動作,應用程式會從轉譯器接收所有 EC_COMPLETE 事件。

備註

轉譯器篩選會在收到資料流程結束通知時傳送此事件。 (資料流程結束會透過 IPin::EndOfStream 方法發出訊號。) 篩選準則會為每個資料流程傳送一個 EC_COMPLETE 事件。 篩選準則必須先處理任何擱置的範例,才能傳送事件。 停止轉譯器會重設快取的任何資料流程結束狀態。

如果轉譯器已暫停,則在呼叫IMediaFilter::Run方法之前,它不會傳送EC_COMPLETE。 此外,它會繼續傳送每個從暫停到執行的 EC_COMPLETE 事件,直到篩選已停止或排清為止。

篩選準則會將 lParam2 參數設定為 IBaseFilter 指標。 如果啟用預設動作,篩選圖表管理員會將此參數設定為零。

規格需求

需求
標頭
Dshow.h

另請參閱

事件通知碼

DirectShow 中的事件通知

替代視訊轉譯器