Función WcsGetDefaultColorProfileSize (icm.h)

  • Artículo

Devuelve el tamaño, en bytes, del nombre de perfil de color predeterminado (incluido el terminador NULL ) de un dispositivo.

Nota

Esta API no admite perfiles de "color avanzado" para monitores HDR. Use ColorProfileGetDisplayDefault para administrar perfiles de color avanzados.

Sintaxis

BOOL WcsGetDefaultColorProfileSize(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  PDWORD                       pcbProfileName
);

Parámetros

scope

Valor WCS_PROFILE_MANAGEMENT_SCOPE que especifica el ámbito de esta operación de administración de perfiles.

pDeviceName

Puntero al nombre del dispositivo para el que se va a obtener el perfil de color predeterminado. Si es NULL, se usará un perfil predeterminado independiente del dispositivo.

cptColorProfileType

Valor COLORPROFILETYPE que especifica el tipo de perfil de color.

cpstColorProfileSubType

Valor COLORPROFILESUBTYPE que especifica el subtipo de perfil de color.

dwProfileID

Identificador del espacio de colores que representa el perfil de color.

pcbProfileName

Puntero a una ubicación que recibe el tamaño, en bytes, del nombre de ruta de acceso del perfil de color predeterminado, incluido el terminador NULL .

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en esta función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Use esta función para devolver el tamaño necesario del búfer al que apunta el parámetro pProfileName en la función WcsGetDefaultColorProfile .

Esta función es ejecutable en Least-Privileged contexto de la cuenta de usuario (LUA).

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]
Encabezado icm.h
Library Mscms.lib
Archivo DLL Mscms.dll

Consulte también