共用方式為

CMCheckColors 函式 (icm.h)

  • 發行項

判斷指定的色彩是否位於指定轉換的輸出 範圍 內。

語法

BOOL CMCheckColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPBYTE       lpaResult
);

參數

hcmTransform

要使用的色彩轉換控制碼。

lpaInputColors

COLOR結構的陣列指標，以檢查輸出遊戲。

nColors

指定陣列中元素的數目。

ctInput

指定輸入色彩類型。

lpaResult

緩衝區的指標，用來放置包含測試結果的位元組陣列。 緩衝區中的每個位元組都會對應至 COLOR 結構，而結束時已設定為介於 0 到 255 之間的不帶正負號值。 值 0 表示色彩在 gamut 中，而非零值表示其不是遊戲。 對於任何整數n，例如 0 <n< 255，結果值n + 1 表示對應的色彩至少與 n 的結果值相同， 這些值通常是從 ICC 設定檔中的 gamutTag 產生。

傳回值

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

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

備註

匯出此函式需要每個 CMM。

如果輸入色彩類型與色彩轉換 CMCheckColors 不相容，則失敗。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 icm.h

另請參閱