Partager via

WcsGetDefaultColorProfileSize, fonction (icm.h)

  • Article

Retourne la taille, en octets, du nom de profil de couleur par défaut (y compris la terminaison NULL ) d’un appareil.

Notes

Cette API ne prend pas en charge les profils de « couleur avancée » pour les moniteurs HDR. Utilisez ColorProfileGetDisplayDefault pour gérer les profils de couleurs avancés.

Syntaxe

BOOL WcsGetDefaultColorProfileSize(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  PDWORD                       pcbProfileName
);

Paramètres

scope

Valeur WCS_PROFILE_MANAGEMENT_SCOPE qui spécifie l’étendue de cette opération de gestion de profil.

pDeviceName

Pointeur vers le nom de l’appareil pour lequel le profil de couleur par défaut doit être obtenu. Si la valeur est NULL, un profil par défaut indépendant de l’appareil est utilisé.

cptColorProfileType

Valeur COLORPROFILETYPE spécifiant le type de profil de couleur.

cpstColorProfileSubType

Valeur COLORPROFILESUBTYPE spécifiant le sous-type de profil de couleur.

dwProfileID

ID de l’espace de couleurs que représente le profil de couleur.

pcbProfileName

Pointeur vers un emplacement qui reçoit la taille, en octets, du nom du chemin d’accès du profil de couleur par défaut, y compris la terminaison NULL .

Valeur retournée

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

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

Remarques

Utilisez cette fonction pour renvoyer la taille requise de la mémoire tampon pointée par le paramètre pProfileName dans la fonction WcsGetDefaultColorProfile .

Cette fonction est exécutable dans Least-Privileged contexte de compte d’utilisateur (LUA).

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

Voir aussi