GetStandardColorSpaceProfileA, fonction (icm.h)

Article
08/24/2023

Récupère le profil de couleur inscrit pour l’espace de couleurs standard spécifié.

Syntaxe

BOOL GetStandardColorSpaceProfileA(
  PCSTR  pMachineName,
  DWORD  dwSCS,
  PSTR   pBuffer,
  PDWORD pcbSize
);

Paramètres

pMachineName

Réservé. Doit avoir la valeur NULL. Ce paramètre est destiné à pointer vers le nom de l’ordinateur sur lequel obtenir un profil d’espace de couleurs standard. Un pointeur NULL indique l’ordinateur local.

dwSCS

Spécifie la valeur d’ID de l’espace de couleurs standard pour lequel récupérer le profil. Les seules valeurs valides pour ce paramètre sont LCS_sRGB et LCS_WINDOWS_COLOR_SPACE.

pBuffer

Pointeur vers la mémoire tampon dans laquelle le nom du profil doit être placé. Si la valeur est NULL, l’appel retourne TRUE et la taille requise de la mémoire tampon est placée dans pdwSize.

pcbSize

Pointeur vers une variable contenant la taille en octets de la mémoire tampon pointée par pProfileName. Au retour, la variable contient la taille de la mémoire tampon réellement utilisée ou nécessaire.

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

Si la mémoire tampon pointée par pProfileName doit être allouée dynamiquement par une application, l’application peut appeler la fonction GetStandardColorSpaceProfile pour récupérer la taille requise pour la mémoire tampon. Si GetStandardColorSpaceProfile est appelé avec pProfileName défini sur NULL, il retourne FALSE et le DWORD pointé vers pdwSize contient le nombre d’octets nécessaires pour la mémoire tampon pointée vers par pProfileName. L’application peut ensuite allouer la mémoire tampon et appeler à nouveau GetStandardColorSpaceProfile avec pProfileName défini sur l’adresse de la mémoire tampon.

Cette fonction prend en charge les profils de modèle d’appareil (DPM) windows Color System (WCS) en plus des profils ICC (International Color Consortium). Il ne prend pas en charge les profils WCS CAMP ou GMMP et retourne une erreur si ces profils sont utilisés.

Vue d’ensemble des fonctionnalités spécifiques de Windows Vista

Cela prend en charge les DPM WCS en plus des profils ICC. Il ne prend pas en charge les profils WCS CAMP ou GMMP et retourne une erreur si ces profils sont utilisés avec cette API.

Prise en charge par utilisateur/LUA

Cela récupère le profil de couleur inscrit pour l’espace de couleur standard donné pour l’utilisateur actuel. S’il n’existe aucun paramètre de ce type pour l’utilisateur actuel, il récupère le paramètre à l’échelle du système.

Cela utilise WcsGetDefaultColorProfile avec WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.

Il s’agit d’un fichier exécutable dans le contexte LUA.

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

Partager via