CMCreateProfile, fonction (icm.h)

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

Crée un profil de couleur d’affichage à partir d’une structure LOGCOLORSPACEA .

Syntaxe

BOOL CMCreateProfile(
  LPLOGCOLORSPACEA lpColorSpace,
  LPDEVCHARACTER   *lpProfileData
);

Paramètres

lpColorSpace

Pointeur vers un espace logique de couleur dont le membre lcsFilename sera NULL.

lpProfileData

Pointeur vers un pointeur vers une mémoire tampon. Si la fonction réussit, alloue et remplit cette mémoire tampon. Il incombe à l’application appelante de libérer cette mémoire tampon lorsqu’elle n’est plus nécessaire.

Valeur retournée

À compter de Windows Vista, le CMM 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 :

La version Unicode de cette fonction est CMCreateProfileW.

Seul le CMM windows par défaut est requis pour exporter cette fonction ; il est facultatif pour toutes les autres machines virtuelles.

Si un CMM ne prend pas en charge CMCreateProfile, Windows utilise le CMM par défaut pour créer le profil.

Le CMM doit définir tous les champs d’en-tête sur des valeurs par défaut sensibles. Ce profil doit être utilisable comme profil d’entrée dans une transformation.

L’application appelante doit libérer la mémoire tampon allouée par cette fonction et pointée par le paramètre lpProfileData . Utilisez GlobalFree pour libérer la mémoire tampon.

Spécifications

Voir aussi

• Concepts de base de la gestion des couleurs
• Fonctions
• CMCreateProfileW