Compartilhar via

Função WcsGetDefaultColorProfile (icm.h)

  • Artigo

Recupera o perfil de cor padrão para um dispositivo ou para um padrão independente do dispositivo se o dispositivo não for especificado.

Observação

Essa API não dá suporte a perfis de "cor avançada" para monitores HDR. Use ColorProfileGetDisplayDefault para gerenciar perfis de cores avançados.

Sintaxe

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

Parâmetros

scope

Um valor WCS_PROFILE_MANAGEMENT_SCOPE especificando 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 é obtido. Se FOR NULL, um perfil padrão independente do dispositivo será obtido.

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.

cbProfileName

O tamanho do buffer, em bytes, do buffer apontado por pProfileName.

pProfileName

Um ponteiro para um buffer para receber o nome do perfil de cor. O tamanho do buffer, em bytes, será o indicado por cbProfileName.

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

Use a função WcsGetDefaultColorProfileSize para obter o tamanho necessário do buffer apontado pelo parâmetro pProfileName .

Se WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER estiver presente, ele substituirá o padrão em todo o sistema para profileManagementScope.

Essa função é executável no contexto da conta de usuário (LUA) Least-Privileged.

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