共用方式為


IOverlay::SetColorKey 方法 (strmif.h)

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

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

語法

HRESULT SetColorKey(
  [in, out] COLORKEY *pColorKey
);

參數

[in, out] pColorKey

要設定之色彩索引鍵值的指標。 如果成功,則會將選取的實際色彩索引鍵值複製到此參數。

傳回值

如果成功,則傳回S_OK,如果 pColorKeyNULL,E_POINTER如果 pColorKey 的值對目前的調色盤或像素格式無效,則傳回E_INVALIDARG。

備註

如果您使用 方法來變更色彩索引鍵 SetColorKey ,則所有建議鏈接都會以新的色彩接收 IOverlayNotify::OnColorKeyChange 回呼方法。

在 palettized 顯示器上使用 IOverlay::建議 時,篩選條件可以使用) 安裝色彩索引鍵 (SetColorKey ,或使用 IOverlay::SetPalette) 來安裝調色盤 (,但不能同時安裝兩者。 這是因為此模式中的色彩索引鍵需要瞭解與 SetPalette 衝突的調色盤。 使用 CK_NOCOLORKEY 旗標要求色彩索引鍵,即可卸載色彩索引鍵。 同樣地,透過 SetPalette 安裝的任何調色盤都可以藉由呼叫 SetPalette 並傳入 NULL 參數 (,也就是 SetPalette (0,NULL) ) 。

安裝色彩索引鍵時嘗試設定調色盤會傳回VFW_E_PALETTE_SET錯誤。 安裝調色盤時嘗試設定色彩索引鍵會傳回VFW_E_COLOR_KEY_SET。

規格需求

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

另請參閱

錯誤和成功碼

IOverlay 介面