共用方式為

IMixerPinConfig：：GetColorKey 方法 (mpconfig.h)

  • 發行項

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

方法 GetColorKey 會擷取影片資料流程所使用的色彩索引鍵。

語法

HRESULT GetColorKey(
  [out] COLORKEY *pColorKey,
  [out] DWORD    *pColor
);

參數

[out] pColorKey

包含索引鍵類型和調色盤索引的 COLORKEY 結構的指標。

[out] pColor

值的指標，指出目前顯示模式為 8 位 Palettized 時所傳回 COLORKEY 的 8 位調色盤索引。 否則，它是值，代表目前顯示模式像素格式的色彩索引鍵。

傳回值

傳回 HRESULT 值。 可能的值如下：

傳回碼 Description
E_INVALIDARG
 不正確引數，這兩個參數都是 Null。
E_FAIL
 GetColorKey 失敗，因為不知道色彩索引鍵。
NOERROR
 成功。

備註

取得主要資料流程上的值將會擷取重迭介面所使用的目的地色彩索引鍵。 在次要針腳上取得此值會傳回該特定資料流程所使用的色彩索引鍵。

此介面的目前 DirectShow 實作可為pColorKey或pColor參數傳回Null;不過，如果兩個參數都是Null，方法將會失敗並傳回E_INVALIDARG。

注意pColor參數傳回的DWORD值是使用的實際色彩。 因此，如果顯示器的位深度是 8、16、24、32 最後 8、16、24 或 32 位的 DWORD ，則指定色彩索引鍵的實際值。
 

規格需求

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

另請參閱

錯誤和成功碼

IMixerPinConfig 介面

IMixerPinConfig：：SetColorKey