Compartilhar via

Função CMCheckColorsInGamut (icm.h)

  • Artigo

[CMCheckColorsInGamut não está mais disponível para uso a partir do Windows Vista.]

Determina se os triplos RGB especificados estão na gama de saída de uma transformação especificada.

Sintaxe

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

Parâmetros

hcmTransform

Especifica a transformação a ser usada.

lpaRGBTriple

Aponta para uma matriz de triplos RGB para marcar.

lpaResult

Aponta para o buffer no qual colocar resultados.

Os resultados são representados por uma matriz de bytes. Cada byte na matriz corresponde a um RGB triplo e tem um valor sem sinal entre 0 e 255. O valor 0 indica que a cor está em gama, enquanto um valor diferente de zero indica que ela está fora de gama. Para qualquer inteiro n no intervalo 0 <n< 255, um valor de resultado de n + 1 indica que a cor correspondente está pelo menos tão distante da gama quanto seria indicado por um valor de resultado n.

nCount

Especifica o número de elementos na matriz.

Retornar valor

A partir do Windows Vista, o CMM padrão (Icm32.dll) retornará FALSE e GetLastError relatará ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP e Windows 2000:

Se essa função for bem-sucedida, o valor retornado será TRUE.

Se essa função falhar, o valor retornado será FALSE. Chame GetLastError para recuperar o erro.

Comentários

A partir do Windows Vista, os Implementadores de CMM não são mais necessários para implementar esse método.

Windows Server 2003, Windows XP e Windows 2000:

Os implementadores de CMM são necessários para implementar esse método.

Cada CMM é necessário para exportar essa função.

Se a função não for bem-sucedida, os CMMs personalizados deverão chamar SetLastError para definir o último erro como um valor de erro válido definido em Winerror.h.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho icm.h

Confira também