Compartir a través de

Función GetICMProfileW (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 GetICMProfileW(
  HDC     hdc,
  LPDWORD pBufSize,
  LPWSTR  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 está en bytes. Para la versión Unicode, el tamaño está en WCHAR. Si esta función se ejecuta correctamente, al devolver este parámetro, contiene el tamaño del búfer usado 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 está usando 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 la función SetICMProfile se usa para establecer el perfil actual, un perfil puede estar asociado 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 con un controlador de dominio. Este perfil se usará como perfil 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 llamar 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 microsoft Layer for 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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