Funzione CMCheckColorsInGamut (icm.h)

  • Articolo

[CMCheckColorsInGamut non è più disponibile per l'uso a partire da Windows Vista.]

Determina se i triple RGB specificati si trovano nella gamma di output di una trasformazione specificata.

Sintassi

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

Parametri

hcmTransform

Specifica la trasformazione da utilizzare.

lpaRGBTriple

Punta a una matrice di triple RGB da controllare.

lpaResult

Punta al buffer in cui inserire i risultati.

I risultati sono rappresentati da una matrice di byte. Ogni byte nella matrice corrisponde a un triplo RGB e ha un valore senza segno compreso tra 0 e 255. Il valore 0 indica che il colore è in gamut, mentre un valore diverso da zero indica che è fuori gamma. Per qualsiasi numero intero n nell'intervallo 0 <n< 255, un valore di risultato pari a n + 1 indica che il colore corrispondente è almeno al di fuori dell'intervallo indicato da un valore di risultato pari a n.

nCount

Specifica il numero di elementi nella matrice.

Valore restituito

A partire da Windows Vista, il CMM predefinito (Icm32.dll) restituirà FALSE e GetLastError restituirà ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP e Windows 2000:

Se questa funzione ha esito positivo, il valore restituito è TRUE.

Se questa funzione ha esito negativo, il valore restituito è FALSE. Chiamare GetLastError per recuperare l'errore.

Commenti

A partire da Windows Vista, gli implementatori CMM non sono più necessari per implementare questo metodo.

Windows Server 2003, Windows XP e Windows 2000:

Gli implementatori CMM sono necessari per implementare questo metodo.

Ogni CMM è necessario per esportare questa funzione.

Se la funzione non riesce, i cmm personalizzati devono chiamare SetLastError per impostare l'ultimo errore su un valore di errore valido definito in Winerror.h.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h

Vedi anche