GetColorProfileHeader 函式 (icm.h)

從 ICC 色彩設定檔或 WCS XML 設定檔擷取或衍生 ICC 標頭結構。驅動程式和應用程式應該假設傳回 TRUE 只表示傳回正確結構化的標頭。每個標記仍然需要使用舊版ICM2 API或 XML 架構 API 獨立驗證。

語法

BOOL GetColorProfileHeader(
  HPROFILE       hProfile,
  PPROFILEHEADER pHeader
);

hProfile

指定有問題的色彩設定檔句柄。

pHeader

指向要放置 ICC 標頭結構的變數。

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

如果此函式失敗，則傳回值為 FALSE。此函式將會失敗，因為 hProfile 參數中參考了無效的 ICC 或 WCS XML 設定檔。如需擴充錯誤資訊，請呼叫 GetLastError。

若要判斷標頭是否衍生自 ICC 或 DMP 配置檔句柄，請檢查標頭簽章 (標頭位元組 36-39) 。如果簽章是「acsp」 (大端) ，則會使用 ICC 配置檔。如果簽章為「cdmp」 (big-endian) 則會使用 DMP。

識別標頭為已「合成」WCS DMP 的辨別功能如下：

pIcmProfileHeader-phSignature> = 'pmdc' (small endian = big endian 'cdmp')

pIcmProfileHeader-phCMMType> = '1scw' (小 endian = big endian 'wcs1') 。