CMCheckColorsInGamut 函式 (icm.h)

[CMCheckColorsInGamut 已不再可供 Windows Vista 使用。]

判斷指定的 RGB 三倍是否位於指定轉換的輸出範圍中。

語法

BOOL CMCheckColorsInGamut(
  HCMTRANSFORM hcmTransform,
  RGBTRIPLE    *lpaRGBTriple,
  LPBYTE       lpaResult,
  UINT         nCount
);

hcmTransform

指定要使用的轉換。

lpaRGBTriple

指向要檢查的 RGB 三倍數位。

lpaResult

指向要在其中放置結果的緩衝區。

結果會以位元組陣組表示。陣列中的每個位元組都會對應至 RGB 三倍，且具有介於 0 到 255 之間的不帶正負號值。值 0 表示色彩在 gamut 中，而非零值表示其不是遊戲。對於範圍 0 <n< 255 中的任何整數 n，結果值為 n + 1 表示對應的色彩至少與 n 的結果值相同。

nCount

指定陣列中元素的數目。

從 Windows Vista 開始，預設的 CMM (Icm32.dll) 會傳回 FALSE ，而 GetLastError 會回報ERROR_NOT_SUPPORTED。

Windows Server 2003、Windows XP 和 Windows 2000：

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

如果此函式失敗，則傳回值為 FALSE。呼叫 GetLastError 以擷取錯誤。

從 Windows Vista 開始，不再需要 CMM 實作器來實作此方法。

Windows Server 2003、Windows XP 和 Windows 2000：

實作此方法需要 CMM 實作器。

匯出此函式需要每個 CMM。

如果函式未成功，自定義 CMM 應該呼叫 SetLastError ，將最後一個錯誤設定為 Winerror.h 中定義的有效錯誤值。