WcsSetDefaultColorProfile, fonction (icm.h)
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 |