IWICBitmapFrameEncode：：SetColorContexts 方法 (wincodec.h)

  • 發行項

將指定的 IWICColorContext 設定檔設定為框架。

語法

HRESULT SetColorContexts(
  [in] UINT             cCount,
  [in] IWICColorContext **ppIColorContext
);

參數

[in] cCount

類型： UINT

要設定的 IWICColorContext 設定檔數目。

[in] ppIColorContext

類型： IWICColorContext**

IWICColorContext 指標的指標，其中包含要設定為框架的色彩內容配置檔。

傳回值

類型： HRESULT

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

備註

  • Bmp不支援設定色彩內容。 此函式會 傳回WINCODEC_ERR_UNSUPPORTEDOPERATION。
  • Png最多支援一個色彩內容設定，而且將會忽略其他色彩內容。 此內容必須是 WICColorContextProfile，並且用來編碼 PNG 檔案中的 iCCP、gAMA 和 cHRM 區塊。
  • JPEG、TIFF、JPEG-XR支持設定一個 WICColorContextProfile 和一個 WICColorContextExifColorSpace 。 使用者不得提供每種色彩內容的一種以上，因為每個類型的最後一個內容除外。 在 JPEG 中， WICColorContextProfile 會編碼為 JPEG APP2 ICC 元數據區塊。

    在 TIFF 和 JPEG-XR 中， WICColorContextProfile 會編碼為 IFD ICC 配置檔元數據區塊， (IFD 標記0x8773) 。 在這三種格式中， WICColorContextExifColorSpace 會編碼為 EXIF 色彩空間元數據區塊， (EXIF 標籤0xA001) 。

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 wincodec.h
程式庫 Windowscodecs.lib