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 は色が色域にあることを示し、0 以外の値は色域外であることを示します。 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 で定義された有効なエラー値に設定する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | icm.h |