IWICDevelopRaw：：SetWhitePointKelvin 方法 (wincodec.h)

設定白點 Kelvin 值。

語法

HRESULT SetWhitePointKelvin(
  [in] UINT WhitePointKelvin
);

參數

[in] WhitePointKelvin

類型： UINT

白色點 Kelvin 值。 可接受的 Kelvin 值為 1,500 到 30,000。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

編解碼器實作者應以原始影像原生方式支援的範圍，以動態方式調整色彩溫度。 對於原生支援範圍以外的值，編解碼器實作器應該以該色彩溫度提供最佳的影像表示法。

如果值超出定義的可接受範圍，編解碼器實作器應該會傳回 WINCODEC_ERR_VALUEOUTOFRANGE 。

編解碼器實作者必須確保與其他白點設定方法的適當互操作性，例如 SetWhitePointRGB。 例如，如果呼叫端透過 SetNamedWhitePoint 設定白點，則編解碼器實作者可能會想要停用回讀對應的 Kelvin 溫度。 在特定情況下，編解碼器實作者因為先前呼叫而想要拒絕指定的動作，應該傳回 WINCODEC_ERR_WRONGSTATE 。

規格需求