GetICMProfileW, fonction (wingdi.h)

Article
08/27/2023

La fonction GetICMProfile récupère le nom de fichier du profil de couleur de sortie actuel pour un contexte d’appareil spécifié.

Syntaxe

BOOL GetICMProfileW(
  HDC     hdc,
  LPDWORD pBufSize,
  LPWSTR  pszFilename
);

Paramètres

hdc

Spécifie un contexte d’appareil à partir duquel récupérer le profil de couleur.

pBufSize

Pointeur vers un DWORD qui contient la taille de la mémoire tampon pointée vers lpszFilename. Pour la version ANSI de cette fonction, la taille est en octets. Pour la version Unicode, la taille est en WCHAR. Si cette fonction réussit, au retour, ce paramètre contient la taille de la mémoire tampon réellement utilisée. Toutefois, si la mémoire tampon n’est pas assez grande, cette fonction retourne FALSE. Dans ce cas, la fonction GetLastError() retourne ERROR_INSUFFICIENT_BUFFER et le DWORD pointé par ce paramètre contient la taille nécessaire pour la mémoire tampon lpszFilename .

pszFilename

Pointe vers la mémoire tampon qui reçoit le nom du chemin d’accès du profil.

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE. Elle retourne également TRUE si le paramètre lpszFilename a la valeur NULL et que la taille requise pour la mémoire tampon est copiée dans lpcbName.

Si cette fonction échoue, la valeur de retour est FALSE.

Remarques

GetICMProfile obtient le nom de fichier du profil de sortie actuel, que la gestion des couleurs soit activée ou non pour le contexte de l’appareil.

Étant donné un contexte d’appareil, GetICMProfile génère, via le paramètre lpszFilename, le nom du chemin d’accès du fichier contenant le profil de couleur actuellement utilisé par le contexte de l’appareil. Il génère également, via le paramètre lpcbName, la longueur de la chaîne contenant le nom du chemin d’accès.

Il est possible que le nom de profil retourné par GetICMProfile ne figure pas dans la liste des profils retournés par EnumICMProfiles. La fonction EnumICMProfiles retourne tous les profils d’espace de couleur associés à un contexte d’appareil (DC) dont les paramètres correspondent à ceux du contrôleur de domaine. Si la fonction SetICMProfile est utilisée pour définir le profil actuel, un profil peut être associé au contrôleur de domaine qui ne correspond pas à ses paramètres. Par instance, la fonction SetICMProfile peut être utilisée pour associer le profil sRGB indépendant de l’appareil à un contrôleur de domaine. Ce profil sera utilisé comme profil WCS actuel pour ce contrôleur de domaine, et les appels à GetICMProfile retourneront son nom de fichier. Toutefois, le profil n’apparaîtra pas dans la liste des profils retournés par EnumICMProfiles.

Si cette fonction est appelée avant tout appel à la fonction SetICMProfile , elle peut être utilisée pour obtenir le profil par défaut d’un contexte d’appareil.

Windows 95/98/Me : GetICMProfileW est pris en charge par la couche Microsoft pour Unicode. Pour cela, vous devez ajouter certains fichiers à votre application, comme indiqué dans Microsoft Layer pour Unicode sur Windows 95/98/Me Systems.

Notes

L’en-tête wingdi.h définit GetICMProfile comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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]
Plateforme cible	Windows
En-tête	wingdi.h
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Partager via