CreateDeviceLinkProfile, fonction (icm.h)

Article
08/24/2023

Crée un profil de liaison d’appareil ICC (International Color Consortium) à partir d’un ensemble de profils de couleur, à l’aide des intentions spécifiées.

Syntaxe

BOOL CreateDeviceLinkProfile(
  PHPROFILE hProfile,
  DWORD     nProfiles,
  PDWORD    padwIntent,
  DWORD     nIntents,
  DWORD     dwFlags,
  PBYTE     *pProfileData,
  DWORD     indexPreferredCMM
);

Paramètres

hProfile

Pointeur vers un tableau de handles des profils de couleur à utiliser. La fonction détermine si les HPROFILEs contiennent des informations de profil ICC et, si c’est le cas, elle les traite de manière appropriée.

nProfiles

Spécifie le nombre de profils dans le tableau pointé vers hProfile.

padwIntent

Pointeur vers un tableau de DWORDS contenant les intentions à utiliser. Consultez Intentions de rendu.

nIntents

Nombre d’intentions dans le tableau pointé vers par padwIntent.

dwFlags

Spécifie les indicateurs pour utiliser la création de contrôle de la transformation. Pour plus d’informations, consultez Indicateurs de création de transformation CMM.

pProfileData

Pointeur vers un pointeur vers une mémoire tampon. Si elle réussit, cette fonction alloue la mémoire tampon, place son adresse dans *pProfileData et la remplit avec un profil de lien d’appareil. Si la fonction réussit, l’application appelante doit libérer la mémoire tampon une fois qu’elle n’est plus nécessaire.

indexPreferredCMM

Spécifie l’index de base unique du profil de couleur qui indique le module de gestion des couleurs (CMM) à utiliser. Le développeur d’applications peut autoriser Windows à choisir la gestion des applications en définissant ce paramètre sur INDEX_DONT_CARE. Consultez Utilisation de modules de gestion des couleurs (CMM).

Valeur retournée

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

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

Notes

Pour les HPROFILEs qui contiennent des informations de profil WCS, les HPROFILEs sont convertis en handles de profil ICC valides, puis ces handles de profil ICC sont utilisés pour créer le profil de liaison d’appareil.

Le premier et le dernier profil du tableau doivent être des profils d’appareil. Les autres profils peuvent être des espaces de couleurs ou des profils abstraits.

L’espace de couleur de sortie de chaque profil doit être l’espace de couleur d’entrée du profil suivant.

L’application appelante doit libérer la mémoire tampon allouée par cette fonction et pointée vers le paramètre pProfileData . La fonction GlobalFree doit être utilisée pour libérer la mémoire tampon.

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

Partager via