Partager via

WcsGetDefaultColorProfile, fonction (icm.h)

  • Article

Récupère le profil de couleur par défaut pour un appareil ou pour une valeur par défaut indépendante de l’appareil si l’appareil n’est pas spécifié.

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 WcsGetDefaultColorProfile(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  DWORD                        cbProfileName,
  LPWSTR                       pProfileName
);

Paramètres

scope

Valeur WCS_PROFILE_MANAGEMENT_SCOPE spécifiant 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 est obtenu. Si la valeur est NULL, un profil par défaut indépendant de l’appareil est obtenu.

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.

cbProfileName

Taille de la mémoire tampon, en octets, de la mémoire tampon pointée par pProfileName.

pProfileName

Pointeur vers une mémoire tampon pour recevoir le nom du profil de couleur. La taille de la mémoire tampon, en octets, sera indiquée par cbProfileName.

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.

Notes

Utilisez la fonction WcsGetDefaultColorProfileSize pour obtenir la taille requise de la mémoire tampon pointée par le paramètre pProfileName .

Si WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER est présent, il remplace la valeur par défaut à l’échelle du système pour profileManagementScope.

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

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