Deprecated. The use of this API is discouraged. The API may be removed from future releases of Windows. For more information, see the Remarks section.
The CMCheckColorsInGamut function determines whether specified RGB triples lie in the output gamut of a specified transform.
BOOL WINAPI CMCheckColorsInGamut( HCMTRANSFORM hcmTransform, RGBTRIPLE *lpaRGBTriple, LPBYTE lpaResult, UINT nCount );
Specifies the transform to use.
Points to an array of RGB triples to check.
Points to the buffer in which to put results.
The results are represented by an array of bytes. Each byte in the array corresponds to an RGB triple and has an unsigned value between 0 and 255. The value 0 denotes that the color is in gamut, while a nonzero value denotes that it is out of gamut. For any integer n such that 0 < n < 255, a result value of n + 1 indicates that the corresponding color is at least as far out of gamut as would be indicated by a result value of n.
Specifies the number of elements in the array.
If this function succeeds, the return value is TRUE.
If this function fails, the return value is FALSE. Call GetLastError to retrieve the error.
In Windows 7, the default CMM (icm32.dll) will return FALSE and GetLastError will report ERROR_NOT_SUPPORTED.
Deprecated: This function was deprecated in Windows Vista. CMM Implementors are no longer required to implement this method.
Every CMM is required to export this function.
If the function is not successful, custom CMMs should call SetLastError to set the last error to a valid error value defined in Winerror.h.
Minimum supported client
|Windows 2000 Professional|
Minimum supported server
|Windows 2000 Server|
Build date: 11/16/2010