Partager via

WcsSetDefaultColorProfile, fonction (icm.h)

  • Article

Définit le nom du profil de couleur par défaut pour le type de profil spécifié dans l’étendue de gestion de profil spécifiée.

Notes

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

Syntaxe

BOOL WcsSetDefaultColorProfile(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  LPCWSTR                      pProfileName
);

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 défini. Si la valeur est NULL, un profil par défaut indépendant de l’appareil est utilisé.

cptColorProfileType

Valeur COLORPROFILETYPE qui spécifie le type de profil de couleur.

cpstColorProfileSubType

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

dwProfileID

ID de l’espace de couleurs que représente le profil de couleur. Il s’agit d’une valeur d’ID personnalisée utilisée pour identifier de manière unique le profil d’espace de couleurs au sein de votre application.

pProfileName

Pointeur vers une mémoire tampon qui contient le nom du profil de couleur. Consultez la section Notes.

Valeur de retour

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.

Notes

Si le paramètre pProfileName a la valeur NULL et que le paramètre profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, les appels suivants à WcsSetDefaultColorProfile retournent le profil par défaut à l’échelle du système.

Si profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, cette fonction est exécutable dans Least-Privileged contexte compte d’utilisateur (LUA). Dans le cas contraire, des privilèges d’administration sont requis. Le profil spécifié doit déjà être installé, mais il n’est peut-être pas encore associé à l’appareil spécifié dans l’étendue de gestion de profil spécifiée.

Si profileManagementScope est WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, cette fonction ne fonctionnera pas correctement si elle est lancée à partir du contexte système et non d’un compte d’utilisateur.

Lorsque WcsSetDefaultColorProfile est appelé pour définir un profil de modèle d’appareil DMP comme profil par défaut pour l’espace de travail RVB ou personnalisé, seul un profil DMP de type RGBVirtualDevice, LCD ou CRT est valide ; toutes les autres ne sont pas valides.

Lorsque WcsSetDefaultColorProfile est appelé pour définir un profil ICC (International Color Consortium) comme profil par défaut pour l’espace de travail RVB ou personnalisé, seul un profil ICC avec la classe « spac » ou « disp » et l’espace de couleur « RVB » est valide ; toutes les autres ne sont pas valides.

Consultez les notes sur les combinaisons valides de type/sous-type de profil.

Configuration requise

   
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