IOverlay：：SetColorKey 方法 (strmif.h)
[與此頁面相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式代碼盡可能重寫為使用新的 API。
方法會 SetColorKey 變更色彩索引鍵。
語法
HRESULT SetColorKey(
[in, out] COLORKEY *pColorKey
);
參數
[in, out] pColorKey
要設定之色彩索引鍵值的指標。 如果成功，則會將選取的實際色彩索引鍵值複製到此參數。
傳回值
如果成功，則傳回S_OK，如果 pColorKey 為 NULL，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 |