Partager via

GetColorProfileElement, fonction (icm.h)

  • Article

Copie les données d’un élément de profil balisé spécifié d’un profil de couleur spécifié dans une mémoire tampon.

Syntaxe

BOOL GetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement,
  PBOOL    pbReference
);

Paramètres

hProfile

Spécifie un handle pour le profil de couleur ICC (International Color Consortium) en question.

tag

Identifie l’élément balisé à partir duquel copier.

dwOffset

Spécifie le décalage par rapport au premier octet des données de l’élément balisé à partir duquel commencer la copie.

pcbElement

Pointeur vers une variable spécifiant le nombre d’octets à copier. Au retour, la variable contient le nombre d’octets réellement copiés.

pElement

Pointeur vers une mémoire tampon dans laquelle les données d’élément balisées doivent être copiées. La mémoire tampon doit contenir au moins autant d’octets que spécifié par la variable pointée par pcbSize. Si le pointeur pBuffer est défini sur NULL, la taille de l’ensemble des données d’élément balisées en octets est retournée à l’emplacement de mémoire pointé par pcbSize, et dwOffset est ignoré. Dans ce cas, la fonction retourne FALSE.

pbReference

Pointe vers une valeur booléenne qui a la valeur TRUE si plusieurs balises dans le profil de couleur font référence aux mêmes données que la balise spécifiée, ou FALSE si ce n’est pas le cas.

Valeur retournée

Si cette fonction réussit, la valeur de retour est différente de zéro.

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

Notes

Cette fonction échoue si hProfile n’est pas un profil ICC (International Color Consortium) valide.

Si le pointeur pBuffer est défini sur NULL, la taille de la totalité des données d’élément balisées en octets est retournée dans la variable pointée par pcbSize, et dwOffset est ignoré.

Cette fonction ne prend pas en charge les profils WINDOWS Color System (WCS) CAMP, DMP et GMMP ; Étant donné que les éléments de profil sont implicitement associés aux types de balises ICC et codés en dur, et qu’il existe de nombreuses bibliothèques d’analyse XML robustes.

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