GetICMProfileA, fonction (wingdi.h)
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 GetICMProfileA(
HDC hdc,
LPDWORD pBufSize,
LPSTR 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 par 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 suffisamment 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.
Dans 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ît 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 Microsoft Layer pour Unicode. Pour l’utiliser, vous devez ajouter certains fichiers à votre application, comme indiqué dans Microsoft Layer pour Unicode sur les systèmes Windows 95/98/Me.
Notes
L’en-tête wingdi.h définit GetICMProfile en tant qu’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. La combinaison 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 |