IOverlayNotify 介面 (strmif.h)

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

介面 IOverlayNotify 會提供上游篩選，例如譯碼器，並通知轉譯窗口的變更。 這包括變更調色盤、色彩索引鍵和視窗位置的通知，以及可見區域 (裁剪) 變更。

大部分的軟體視訊譯碼器都會讓影片轉譯器透過將媒體範例傳遞至轉譯器輸入針腳上的 IMemInputPin 介面，來繪製其產生的解壓縮影像。

不過，某些影片譯碼篩選 (通常是硬體解壓縮面板，) 使用 VGA 連接器來處理影像本身的繪圖。 這些篩選不需要使用 IMemInputPin，而是可以使用轉譯器輸入針腳所提供的 IOverlay 介面。 透過這個介面，譯碼器可以在視窗位置或大小變更時收到通知，或當目前的系統調色盤變更時，才能安裝和變更色彩索引鍵和調色盤。

執行自己繪圖的譯碼器應該實 IOverlayNotify 作 和 IOverlayNotify2 介面。 每當視窗大小或位置變更、系統調色盤變更或使用不同的色彩索引鍵時，轉譯器都會使用此介面來通知譯碼器。 譯碼器應該在轉譯器的輸入針腳上呼叫 IOverlay：：Advise 方法，以設定回呼。 建立回呼之後，轉譯器會在發生適當的事件時呼叫譯碼器 IOverlayNotify 的方法。 若要取消回呼，請使用 IOverlay：：Unadvise 方法。

視訊轉譯器是呼叫這個介面上方法的唯一篩選。 這是由預設視訊轉譯器自動完成。 如果您要撰寫取代的視訊轉譯器，如果您的篩選支援 IOverlay ，且此介面會在 IOverlay：：Advise 呼叫中傳遞至您的篩選，則必須使用此介面上的方法。

繼承

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

方法

IOverlayNotify 介面具有這些方法。

IOverlayNotify：：OnClipChange OnClipChange 方法會提供視窗可見區域已變更的通知。 請務必更新任何重疊硬體，以在從此方法傳回之前反映可見區域的變更。
IOverlayNotify：：OnColorKeyChange OnColorKeyChange 方法會提供視窗色彩索引鍵已變更的通知。
IOverlayNotify：：OnPaletteChange OnPaletteChange 方法會提供視窗調色盤已變更的通知。
IOverlayNotify：：OnPositionChange OnPositionChange 方法會提供已變更位置的通知。

規格需求

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