Fonction CMCheckColorsInGamut (icm.h)

Article
02/26/2024

[CMCheckColorsInGamut n’est plus disponible pour une utilisation à partir de Windows Vista.]

Détermine si les triples RVB spécifiés se trouvent dans la gamme de sortie d’une transformation spécifiée.

Syntaxe

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

Paramètres

hcmTransform

Spécifie la transformation à utiliser.

lpaRGBTriple

Pointe vers un tableau de triples RVB pour case activée.

lpaResult

Pointe vers la mémoire tampon dans laquelle placer les résultats.

Les résultats sont représentés par un tableau d’octets. Chaque octet du tableau correspond à un triple RVB et a une valeur non signée comprise entre 0 et 255. La valeur 0 indique que la couleur est en gamut, tandis qu’une valeur différente de zéro indique qu’elle est hors gamut. Pour n’importe quel entier n de la plage 0 <n< 255, une valeur de résultat de n + 1 indique que la couleur correspondante est au moins aussi éloignée de la gamut que l’indique une valeur de résultat de n.

nCount

Spécifie le nombre d'éléments du tableau.

Valeur retournée

À compter de Windows Vista, la mmao par défaut (Icm32.dll) retourne FALSE et GetLastError signale ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP et Windows 2000 :

Si cette fonction réussit, la valeur de retour est TRUE.

Si cette fonction échoue, la valeur de retour est FALSE. Appelez GetLastError pour récupérer l’erreur.

Remarques

À compter de Windows Vista, les implémenteurs CMM ne sont plus nécessaires pour implémenter cette méthode.

Windows Server 2003, Windows XP et Windows 2000 :

Les implémenteurs CMM sont nécessaires pour implémenter cette méthode.

Chaque CMM est nécessaire pour exporter cette fonction.

Si la fonction échoue, les machines virtuelles personnalisées doivent appeler SetLastError pour définir la dernière erreur sur une valeur d’erreur valide définie dans Winerror.h.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	icm.h

Partager via