cmGetPS2ColorRenderingIntent 函式 (icm.h)

從配置檔擷取 PostScript 層級 2 色彩轉譯意圖。

語法

BOOL CMGetPS2ColorRenderingIntent(
  HPROFILE hProfile,
  DWORD    dwIntent,
  LPBYTE   lpBuffer,
  LPDWORD  lpcbSize
);

hProfile

指定要使用的配置檔。

dwIntent

指定要擷取的轉譯意圖。可以是下列值之一：

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

如需詳細資訊，請參閱轉譯意圖。

lpBuffer

指向要放置色彩轉譯意圖的緩衝區。如果指標為 NULL，此函式會傳回 *lmicrosoftSize 中這個緩衝區所需的大小。

lpcbSize

指向指定緩衝區大小的變數。傳回時，變數包含的位元組數目實際上會複製到緩衝區。

如果此函式成功，則傳回值為TRUE。如果呼叫的 lpBuffer 設定為 NULL，而且所需的緩衝區大小會複製到 lsize，它也會傳回 TRUE。

如果此函式失敗，則傳回值為 FALSE。發生這種情況時，CMM 應該呼叫 SetLastError ，將最後一個錯誤設定為 Winerror.h 中定義的有效錯誤值。

對於所有 CMM 而言，此函式是選擇性的。

如果 CMM 不支援此函式，Windows 會使用預設 CMM 來取得色彩轉譯意圖。

如果 標記不存在於 hProfile 所指示的配置檔中，CMM 會建立它。產生的轉譯意圖可以做為 PostScript 層級 2 findcolorrendering 運算子的操作數。