(mpconfig.h) IMixerPinConfig：：SetColorKey 方法
[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼，以使用新的 API。]
方法 SetColorKey 會設定視訊數據流所使用的色彩索引鍵。
語法
HRESULT SetColorKey(
[in] COLORKEY *pColorKey
);
參數
[in] pColorKey
COLORKEY 結構的指標。
傳回值
傳回 HRESULT 值。
備註
色彩索引鍵一詞會根據所參考的數據流而有不同的意義。 主要數據流的色彩索引鍵是指重疊表面所使用的目的地色彩索引鍵。 次要數據流的色彩索引鍵是指從螢幕外表面到主要表面時所使用的來源色彩索引鍵。
應用程式應該將主要針腳的色彩索引鍵設定為遮蔽色彩， (某些色彩，在所有機率中都不會出現在桌面) 上。 重迭混音器篩選會嘗試挑選遮蔽的色彩，但如果應用程式知道指定的色彩是其他內容的一部分，應用程式應該變更它。
在次要數據流上設定色彩索引鍵可用來讓數據流變成透明，並啟用非矩形影像。 例如，如果次要數據流是隱藏式輔助字幕文字，則隱藏式輔助字幕文字譯碼器應該在背景中繪製純色，然後將對應釘選的色彩索引鍵設定為該色彩。 這可確保除了色彩索引鍵所指定的圖元之外，所有像素都會傳輸。 可能的話，應用程式應該將次要數據流的色彩索引鍵設定為與主要數據流的色彩索引鍵相同，以提供稍微的效能優勢。
在主要數據流上設定此值會設定重疊表面所使用的目的地色彩索引鍵。 根據預設，目的地色彩索引鍵會作為所有透明 (次要) 數據流的色彩索引鍵。
pColorKey 參數的有效自變數包括當視訊顯示模式設定為 256 種色彩時CK_INDEX，而當視訊顯示模式設定為較高的色彩深度時，CK_RGB，例如 hi-color、24 位或 32 位。 CK_RGB旗標必須與CK_INDEX一起指定。 如果已設定CK_INDEX旗標，則索引將會在 256 色彩模式中當做調色盤索引使用。 但是您必須提供色彩有效的 COLORREF ，如此一來，如果即時變更顯示模式，DirectShow 就可以切換為使用指定的 true 色彩。 這是因為許多真正的色彩可以對應至單一調色盤索引，但從調色盤索引到另一種方式不是一對一。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mpconfig.h |
| 程式庫 | Strmiids.lib |