Compartir a través de

Función CMCheckColorsInGamut (icm.h)

  • Artículo

[CMCheckColorsInGamut ya no está disponible para su uso en Windows Vista.]

Determina si los triples RGB especificados se encuentran en la gama de salida de una transformación especificada.

Sintaxis

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

Parámetros

hcmTransform

Especifica la transformación que se va a usar.

lpaRGBTriple

Apunta a una matriz de triples RGB que se van a comprobar.

lpaResult

Apunta al búfer en el que se van a colocar los resultados.

Los resultados se representan mediante una matriz de bytes. Cada byte de la matriz corresponde a un triple RGB y tiene un valor sin signo entre 0 y 255. El valor 0 indica que el color está en gama, mientras que un valor distinto de cero indica que está fuera de la gama. Para cualquier entero n del intervalo 0 <n< 255, un valor de resultado de n + 1 indica que el color correspondiente es al menos tan lejos de la gama como se indicaría con un valor de resultado de n.

nCount

Especifica el número de elementos de la matriz.

Valor devuelto

A partir de Windows Vista, el CMM predeterminado (Icm32.dll) devolverá FALSE y GetLastError notificará ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP y Windows 2000:

Si esta función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en esta función, el valor devuelto es FALSE. Llame a GetLastError para recuperar el error.

Comentarios

A partir de Windows Vista, los implementadores de CMM ya no son necesarios para implementar este método.

Windows Server 2003, Windows XP y Windows 2000:

Los implementadores de CMM son necesarios para implementar este método.

Cada CMM es necesario para exportar esta función.

Si la función no se ejecuta correctamente, las CMM personalizadas deben llamar a SetLastError para establecer el último error en un valor de error válido definido en Winerror.h.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado icm.h

Consulte también