IMediaFilter 介面 (strmif.h)

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

介面 IMediaFilter 會控制篩選準則的串流狀態。

所有 DirectShow 篩選都會實作此介面。 它提供在狀態之間切換篩選的方法， (已停止、暫停和執行) ;用於擷取篩選準則的目前狀態;和 ，用於設定參考時鐘。 應用程式不應該在篩選上呼叫 IMediaFilter 方法。

Filter Graph 管理員也會公開此介面。 應用程式可以使用 SetSyncSource 方法來設定圖形參考時鐘，以及 GetSyncSource 來擷取時鐘。 應用程式不應該在此介面上呼叫其他方法。 請改用 IMediaControl 介面上的對應方法。

IBaseFilter介面繼承自 IMediaFilter 。

繼承

IMediaFilter介面繼承自IPersist。 IMediaFilter 也有下列類型的成員：

方法

IMediaFilter介面具有這些方法。

IMediaFilter：：GetState GetState 方法會擷取篩選 (執行、停止或暫停) 的狀態。
IMediaFilter：：GetSyncSource GetSyncSource 方法會擷取目前的參考時鐘。
IMediaFilter：:P ause Pause 方法會暫停篩選。
IMediaFilter：：Run Run 方法會執行篩選。
IMediaFilter：：SetSyncSource SetSyncSource 方法會設定參考時鐘。
IMediaFilter：：Stop Stop 方法會停止篩選。

規格需求

最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	strmif.h (包含 Dshow.h)