Función WcsSetDefaultColorProfile (icm.h)
Establece el nombre de perfil de color predeterminado para el tipo de perfil especificado en el ámbito de administración de perfiles especificado.
Nota:
Esta API no admite perfiles de "color avanzado" para monitores HDR. Use ColorProfileSetDisplayDefaultAssociation para administrar perfiles de color avanzados.
Sintaxis
BOOL WcsSetDefaultColorProfile(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pDeviceName,
COLORPROFILETYPE cptColorProfileType,
COLORPROFILESUBTYPE cpstColorProfileSubType,
DWORD dwProfileID,
LPCWSTR pProfileName
);
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 establecer el perfil de color predeterminado. Si es NULL, se usa 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. Se trata de un valor de identificador personalizado que se usa para identificar de forma única el perfil de espacio de colores dentro de la aplicación.
pProfileName
Puntero a un búfer que contiene el nombre del perfil de color. Vea la sección Comentarios.
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
Si el parámetro pProfileName es NULL y el parámetro profileManagementScope se WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, las llamadas posteriores a WcsSetDefaultColorProfile devolverán el perfil predeterminado de todo el sistema.
Si profileManagementScope es WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, esta función es ejecutable en Least-Privileged contexto de cuenta de usuario (LUA). De lo contrario, se requieren privilegios administrativos. El perfil especificado ya debe estar instalado, pero es posible que aún no esté asociado al dispositivo especificado en el ámbito de administración de perfiles especificado.
Si profileManagementScope está WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, esta función no funcionará correctamente si se inicia desde el contexto del sistema y no una cuenta de usuario.
Cuando se llama a WcsSetDefaultColorProfile para establecer un perfil de modelo de dispositivo DMP como perfil predeterminado para el espacio de trabajo RGB o personalizado, solo es válido un perfil DMP que sea de tipo RGBVirtualDevice, LCD o CRT; todos los demás no son válidos.
Cuando se llama a WcsSetDefaultColorProfile para establecer un perfil de International Color Consortium (ICC) como perfil predeterminado para el espacio de trabajo RGB o personalizado, solo es válido un perfil ICC con la clase "spac" o "disp" y "RGB" espacio de colores; todos los demás no son válidos.
Vea notas sobre combinaciones válidas de tipo o subtipo de perfil.
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 |