共用方式為

checkColorsInGamut 函式 (wingdi.h)

  • 發行項

CheckColorsInGamut 函式會判斷指定的 RGB 三重組是否位於指定裝置的輸出範圍中。 RGB 三倍會在輸入邏輯色彩空間中解譯。

語法

BOOL CheckColorsInGamut(
  HDC         hdc,
  LPRGBTRIPLE lpRGBTriple,
  LPVOID      dlpBuffer,
  DWORD       nCount
);

參數

hdc

處理要檢查其輸出遊戲的裝置內容。

lpRGBTriple

要檢查之 RGB 三倍陣列的指標。

dlpBuffer

要放置結果之緩衝區的指標。 此緩衝區必須至少為 nCount 位元組的大小。

nCount

三倍陣列中的項目數目。

傳回值

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

如果此函式失敗，則傳回值為零。

備註

函式會將測試結果放在 lpBuffer 指向的緩衝區中。 緩衝區中的每個位元組都會對應至 RGB 三倍，且在 CM_IN_GAMUT (= 0) 和 CM_OUT_OF_GAMUT (= 255) 之間具有不帶正負號的值。 值 0 表示色彩在 gamut 中，而非零值表示其不是色板。 對於任何整數 n ，例如 0 <n< 255，結果值 n + 1 表示對應的色彩至少與 N 的結果值 n 相差，如 ICC 配置檔格式規格所指定。 如需有關 ICC 設定檔格式規格的詳細資訊，請參閱 進一步資訊 中列出的來源。

請注意，為了讓此函式成功，必須針對透過 hDC 參數傳入的裝置內容句柄啟用 WCS。 您可以藉由呼叫 SetICMMode 函式，為裝置內容句柄啟用 WCS。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 wingdi.h
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱