Compartilhar via


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

Confira também