共用方式為

IVideoWindow：:p ut_BackgroundPalette 方法 (control.h)

  • 發行項

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

方法 put_BackgroundPalette 會指定視訊視窗是否在背景中實現其調色盤。

語法

HRESULT put_BackgroundPalette(
  [in] long BackgroundPalette
);

參數

[in] BackgroundPalette

指定影片轉譯器是否在背景中實現調色盤。 必須為下列其中一個值：

值 Description
OATRUE 影片轉譯器會在背景實現調色盤。
OAFALSE 影片轉譯器不會在背景中實現調色盤。 (預設值。)

傳回值

可能的傳回值包括下列各項：

傳回碼 Description
E_INVALIDARG
 無效引數。
S_OK
 成功。
VFW_E_NOT_CONNECTED
 影片轉譯器篩選未連接。

備註

如果 BackgroundPalette 是 OATRUE ，而視訊影像需要調色盤，影片轉譯器就會在背景中發現該調色盤。 調色盤使用的任何色彩都會在繪圖之前變更為最接近的顯示調色盤中的相符專案。 這可確保應用程式不會干擾其調色盤。 不過，它會對影片造成嚴重的效能負面影響。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 control.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IVideoWindow 介面

IVideoWindow：：get_BackgroundPalette