Función WcsGetDefaultColorProfile (icm.h)

  • Artículo

Recupera el perfil de color predeterminado para un dispositivo o para un valor predeterminado independiente del dispositivo si no se especifica el dispositivo.

Nota:

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

Sintaxis

BOOL WcsGetDefaultColorProfile(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  DWORD                        cbProfileName,
  LPWSTR                       pProfileName
);

Parámetros

scope

Valor de 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 obtiene el perfil de color predeterminado. Si es NULL, se obtiene 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.

cbProfileName

Tamaño del búfer, en bytes, del búfer al que apunta pProfileName.

pProfileName

Puntero a un búfer para recibir el nombre del perfil de color. El tamaño del búfer, en bytes, será el indicado por cbProfileName.

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 la función WcsGetDefaultColorProfileSize para obtener el tamaño necesario del búfer al que apunta el parámetro pProfileName .

Si WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER está presente, invalida el valor predeterminado de todo el sistema para profileManagementScope.

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

Requisitos

   
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