SetColorProfileElement 函式 (icm.h)

在 ICC 色彩設定檔中設定標記設定檔元素的項目數據。

語法

BOOL SetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement
);

hProfile

指定有問題的 ICC 設定檔句柄。

tag

識別標記的專案。

dwOffset

指定要開始寫入之標記項目數據的第一個字節的位移。

pcbElement

包含要寫入之數據位元組數目的變數指標。傳回時，它包含實際寫入的位元元組數目。

pElement

緩衝區的指標，其中包含要寫入色彩配置檔中標記項目的數據。

如果此函式成功，則傳回值為 TRUE。

如果此函式失敗，則傳回值為 FALSE。如需擴充錯誤資訊，請呼叫 GetLastError。

如果 hProfile 不是有效的 ICC 設定檔，此函式將會失敗。

如果未針對讀取/寫入許可權開啟色彩配置檔，則此函式會失敗。

如果 dwOffset 超過指定標記專案的大小設定，則此函式會失敗。

如果 dwOffset + *mbSize 大於指定元素的大小，則此函式只會寫入符合專案目前大小的位元元組數。

當此函式成功時，會覆寫標記專案指定部分中的任何現有數據。

此函式不支援 Windows 色彩系統 (WCS) 配置檔 CAMP、DMP 和 GMMP;因為配置文件專案會隱含地與和硬式編碼至 ICC 標籤類型相關聯，而且有許多強固的 XML 剖析連結庫。