共用方式為


IOverlay 介面 (strmif.h)

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

IOverlay介面提供資訊,讓篩選條件可以直接寫入視訊記憶體,同時將視訊放在正確的視窗位置。 它會在視訊轉譯器的輸入針腳上實作,並與上游篩選 (通常是視訊解壓縮器) ,方法是呼叫該篩選的 IOverlayNotify 方法來通知它對視訊視窗的變更。

此介面與 DirectDraw® 重疊功能沒有關聯性。 Microsoft 影片轉譯器會在可用時使用 DirectDraw 重疊,透過 IMemInputPin 介面來繪製它收到的數據。 這個介面是用來取代 IMemInputPin,旨在提供任何略過轉譯器繪圖功能的上游篩選的通知支援,但需要其他顯示屬性的通知。

如需 和 IOverlayNotify 介面如何搭配運作的詳細資訊,IOverlay請參閱 IOverlayNotify 參考頁面。

如需轉譯視窗變更異步通知的詳細資訊,請參閱 IOverlayNotify2 介面。

此介面會在 Microsoft® DirectShow® 影片轉譯器篩選上實作。 如有需要,也可以在取代視訊轉譯器篩選上實作。 如果這樣做,請實作此介面,以便篩選直接寫入框架緩衝區,或嘗試放置重疊知道顯示其視訊的位置。 若要實作此介面,轉譯器必須準備好在 IOverlayNotify 介面或執行繪圖之篩選的 IOverlayNotify2 介面上使用方法,並通知視訊屬性變更。

DirectShow 中的視窗型轉譯器同時支援 IMemInputPinIOverlay 介面。 這兩個介面互斥。 篩選條件會選擇使用 IOverlay 傳輸,方法是在連線期間提供具有子類型MEDIASUBTYPE_Overlay的媒體類型。 連線之後,它就能夠成功 IOverlay 取得及使用 介面。 如果它與任何其他視訊格式 (連線,例如MEDIASUBTYPE_RGB8) ,則嘗試透過 IOverlay 傳回呼叫 VFW_E_NOT_OVERLAY_CONNECTION。

從上游篩選條件使用此函式的方法,該篩選條件必須控制視訊重疊屬性,並想要處理視訊數據本身的顯示。 這通常是由具有視訊硬體替代連線的硬體視訊譯碼器使用。

繼承

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

方法

IOverlay 介面具有這些方法。

 
IOverlay::建議

建議方法會為 dwInterests 參數所指定的重疊事件設定建議連結。
IOverlay::GetClipList

GetClipList 方法會擷取裁剪清單。
IOverlay::GetColorKey

GetColorKey 方法會擷取用於 chroma 索引鍵的目前色彩索引鍵。
IOverlay::GetDefaultColorKey

GetDefaultColorKey 方法會擷取用於色碼重疊的預設色彩索引鍵。
IOverlay::GetPalette

GetPalette 方法會擷取目前的系統選擇區。
IOverlay::GetVideoPosition

GetVideoPosition 方法會擷取目前的視訊來源和目的地矩形。
IOverlay::GetWindowHandle

GetWindowHandle 方法會擷取目前的視窗句柄。
IOverlay::SetColorKey

SetColorKey 方法會變更色彩索引鍵。
IOverlay::SetPalette

SetPalette 方法會設定調色盤。
IOverlay::Unadvise

Unadvise 方法會終止以 IOverlayNotify 介面建立的建議連結。

規格需求

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