Compartir a través de

Función GetICMProfileA (wingdi.h)

  • Artículo

La función GetICMProfile recupera el nombre de archivo del perfil de color de salida actual para un contexto de dispositivo especificado.

Sintaxis

BOOL GetICMProfileA(
  HDC     hdc,
  LPDWORD pBufSize,
  LPSTR   pszFilename
);

Parámetros

hdc

Especifica un contexto de dispositivo desde el que se va a recuperar el perfil de color.

pBufSize

Puntero a un DWORD que contiene el tamaño del búfer al que apunta lpszFilename. Para la versión ANSI de esta función, el tamaño es en bytes. Para la versión Unicode, el tamaño está en WCHAR. Si esta función es correcta, al devolver este parámetro, contiene el tamaño del búfer que se usa realmente. Sin embargo, si el búfer no es lo suficientemente grande, esta función devuelve FALSE. En este caso, la función GetLastError() devuelve ERROR_INSUFFICIENT_BUFFER y el DWORD al que apunta este parámetro contiene el tamaño necesario para el búfer lpszFilename .

pszFilename

Apunta al búfer que recibe el nombre de ruta de acceso del perfil.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE. También devuelve TRUE si el parámetro lpszFilename es NULL y el tamaño necesario para el búfer se copia en lpcbName.

Si se produce un error en esta función, el valor devuelto es FALSE.

Comentarios

GetICMProfile obtiene el nombre de archivo del perfil de salida actual independientemente de si la administración de colores está habilitada o no para el contexto del dispositivo.

Dado un contexto de dispositivo, GetICMProfile generará, a través del parámetro lpszFilename, el nombre de ruta de acceso del archivo que contiene el perfil de color que usa actualmente el contexto del dispositivo. También generará, a través del parámetro lpcbName, la longitud de la cadena que contiene el nombre de la ruta de acceso.

Es posible que el nombre del perfil devuelto por GetICMProfile no esté en la lista de perfiles devueltos por EnumICMProfiles. La función EnumICMProfiles devuelve todos los perfiles de espacio de color asociados a un contexto de dispositivo (DC) cuya configuración coincide con la del controlador de dominio. Si se usa la función SetICMProfile para establecer el perfil actual, se puede asociar un perfil al controlador de dominio que no coincide con su configuración. Por ejemplo, la función SetICMProfile se puede usar para asociar el perfil sRGB independiente del dispositivo a un controlador de dominio. Este perfil se usará como el perfil de WCS actual para ese controlador de dominio y las llamadas a GetICMProfile devolverán su nombre de archivo. Sin embargo, el perfil no aparecerá en la lista de perfiles que se devuelven de EnumICMProfiles.

Si se llama a esta función antes de cualquier llamada a la función SetICMProfile , se puede usar para obtener el perfil predeterminado para un contexto de dispositivo.

Windows 95/98/Me: GetICMProfileW es compatible con la capa de Microsoft para Unicode. Para usarlo, debe agregar determinados archivos a la aplicación, como se describe en Microsoft Layer for Unicode en Windows 95/98/Me Systems.

Nota

El encabezado wingdi.h define GetICMProfile como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también