Share via

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

另請參閱

錯誤和成功碼

IOverlay 介面