Partager via

GetColorProfileFromHandle, fonction (icm.h)

  • Article

Avec un handle pour un profil de couleur ouvert, la fonction GetColorProfileFromHandle copie le contenu du profil dans une mémoire tampon fournie par l’application. Si le handle est un handle WCS (Windows Color System), le DMP est retourné et les valeurs CAMP et GMMP associées au HPROFILE sont ignorées.

Syntaxe

BOOL GetColorProfileFromHandle(
  HPROFILE hProfile,
  PBYTE    pProfile,
  PDWORD   pcbProfile
);

Paramètres

hProfile

Gérer dans un profil de couleur ouvert. La fonction détermine si le fichier HPROFILE contient des informations de profil ICC ou WCS.

pProfile

Pointeur vers la mémoire tampon pour recevoir des données de profil ICC ou DMP brutes. Peut être NULL. Si tel est le cas, la taille requise pour la mémoire tampon sera stockée dans l’emplacement de mémoire pointé par pcbSize. La mémoire tampon peut être allouée à la taille appropriée, et cette fonction est appelée à nouveau avec pBuffer contenant l’adresse de la mémoire tampon.

pcbProfile

Pointeur vers un DWORD qui contient la taille de la mémoire tampon pointée vers pBuffer. Au retour, il est rempli avec la taille de la mémoire tampon qui a été réellement utilisée si la fonction réussit. Si cette fonction est appelée avec pBuffer défini sur NULL, ce paramètre contient la taille de la mémoire tampon requise.

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE. Il retourne FALSE si le paramètre pBuffer a la valeur NULL et que la taille requise pour la mémoire tampon est copiée dans pcbSize.

Si cette fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Spécifications

   
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
Bibliothèque Mscms.lib
DLL Mscms.dll

Voir aussi