Função WcsSetDefaultColorProfile (icm.h)
Define o nome do perfil de cor padrão para o tipo de perfil especificado no escopo de gerenciamento de perfil especificado.
Observação
Essa API não dá suporte a perfis de "cor avançada" para monitores HDR. Use ColorProfileSetDisplayDefaultAssociation para gerenciar perfis de cores avançados.
Sintaxe
BOOL WcsSetDefaultColorProfile(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pDeviceName,
COLORPROFILETYPE cptColorProfileType,
COLORPROFILESUBTYPE cpstColorProfileSubType,
DWORD dwProfileID,
LPCWSTR pProfileName
);
Parâmetros
scope
Um valor WCS_PROFILE_MANAGEMENT_SCOPE que especifica o escopo dessa operação de gerenciamento de perfil.
pDeviceName
Um ponteiro para o nome do dispositivo para o qual o perfil de cor padrão deve ser definido. Se FOR NULL, um perfil padrão independente do dispositivo será usado.
cptColorProfileType
Um valor COLORPROFILETYPE que especifica o tipo de perfil de cor.
cpstColorProfileSubType
Um valor COLORPROFILESUBTYPE que especifica o subtipo de perfil de cor.
dwProfileID
A ID do espaço de cor que o perfil de cor representa. Esse é um valor de ID personalizado usado para identificar exclusivamente o perfil de espaço de cor em seu aplicativo.
pProfileName
Um ponteiro para um buffer que contém o nome do perfil de cor. Consulte Observações.
Valor retornado
Se essa função for bem-sucedida, o valor retornado será TRUE.
Se essa função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Se o parâmetro pProfileName for NULL e o parâmetro profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, as chamadas subsequentes para WcsSetDefaultColorProfile retornarão o perfil padrão em todo o sistema.
Se profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, essa função será executável no contexto da conta de usuário Least-Privileged (LUA). Caso contrário, privilégios administrativos são necessários. O perfil especificado já deve estar instalado, mas pode ainda não estar associado ao dispositivo especificado no escopo de gerenciamento de perfil especificado.
Se profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, essa função não funcionará corretamente se for iniciada do contexto do sistema e não de uma Conta de Usuário.
Quando WcsSetDefaultColorProfile é chamado para definir um DMP de perfil de modelo de dispositivo como o perfil padrão para o espaço de trabalho RGB ou personalizado, somente um perfil DMP do tipo RGBVirtualDevice, LCD ou CRT é válido; todos os outros são inválidos.
Quando WcsSetDefaultColorProfile é chamado para definir um perfil do ICC (International Color Consortium) como o perfil padrão para o espaço de trabalho RGB ou personalizado, somente um perfil ICC com classe "spac" ou "disp" e espaço de cor "RGB" é válido; todos os outros são inválidos.
Consulte observações sobre combinações válidas de tipo de perfil/subtipo.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | icm.h |
| Biblioteca | Mscms.lib |
| DLL | Mscms.dll |