IWICDevelopRaw：：SetNamedWhitePoint 方法 (wincodec.h)

設定源檔的具名白點。

語法

HRESULT SetNamedWhitePoint(
  [in] WICNamedWhitePoint WhitePoint
);

參數

[in] WhitePoint

類型： WICNamedWhitePoint

列舉值的位元組合。

傳回值

類型： HRESULT

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

備註

如果原始影像不支援具名白點，或源檔包含此 API 不支援的具名白點，編解碼器實作者仍應將此功能標示為受支援。

如果未經處理的影像不支援具名白點，即使影像不是源文件預先定義的白點，也應該盡最大努力將影像調整為具名白點。

如果源檔包含此 API 不支援的具名白點，編解碼器實作者應該支援 API 中的具名白點。

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

規格需求