IDistributorNotify 介面 (strmif.h)

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

介面 IDistributorNotify 可讓外掛程式散發者在篩選圖形變更時收到通知。

應用程式永遠不會使用此介面。 如果您要撰寫外掛程式散發者 (PID) ，並想要 PID 接收篩選圖形組合中控件和變更的通知，請實作此介面。

篩選圖形管理員會在它匯總的任何外掛程式散發者上查詢此介面。 如果 PID 公開此介面，篩選圖形管理員會先呼叫 IDistributorNotify 方法，通知任何狀態變更的 PID，再呼叫篩選條件上的對等 IBaseFilter 方法。 Filter Graph 管理員也會在新增或移除篩選時呼叫 IDistributorNotify：：NotifyGraphChange 方法，或任何釘選連線變更。

在呼叫任何 IDistributorNotify 方法期間，請勿保存任何可能由另一個程式代碼路徑所保留的重要區段，而該路徑會呼叫 Filter Graph Manager 上的方法。 這樣做可能會導致死結。

繼承

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

方法

IDistributorNotify 介面具有這些方法。

IDistributorNotify：：NotifyGraphChange 當篩選圖形中的篩選集變更或任何針腳連線變更時，會呼叫 NotifyGraphChange 方法。
IDistributorNotify：:P ause 當篩選圖形進入暫停狀態時，會呼叫Pause方法。
IDistributorNotify：：Run 當篩選圖形進入執行中狀態時，會呼叫 Run 方法。
IDistributorNotify：：SetSyncSource 註冊新的時鐘時，會呼叫 SetSyncSource 方法。
IDistributorNotify：：Stop 當篩選圖形進入停止狀態時，會呼叫 Stop 方法。

規格需求

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

另請參閱

外掛程式散發者