Compartilhar via

Função AssociateColorProfileWithDeviceA (icm.h)

  • Artigo

Associa um perfil de cor especificado a um dispositivo especificado.

Observação

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

Sintaxe

BOOL AssociateColorProfileWithDeviceA(
  PCSTR pMachineName,
  PCSTR pProfileName,
  PCSTR pDeviceName
);

Parâmetros

pMachineName

Reservado. Deve ser NULL. Esse parâmetro destina-se a apontar para o nome do computador no qual associar o perfil e o dispositivo especificados. Um ponteiro NULL indica o computador local.

pProfileName

Aponta para o nome do arquivo a ser associado.

pDeviceName

Aponta para o nome do dispositivo a ser associado.

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

A função AssociateColorProfileWithDevice falhará se o perfil não tiver sido instalado no computador usando a função InstallColorProfileW .

Observe que, no Windows (Windows 95 ou posterior), o driver de dispositivo PostScript para impressoras pressupõe um modelo de cores CMYK. Portanto, todas as impressoras PostScript devem usar um perfil de cor CMYK. O Windows 2000 não tem essa limitação.

Se o dispositivo especificado for um monitor, essa função atualizará o perfil padrão.

Vários perfis normalmente são associados a impressoras, com base em tipos de papel e tinta. Não há nenhum padrão. O GDI seleciona o melhor dos perfis associados quando seu aplicativo cria um DC (contexto de dispositivo).

Os scanners também não têm perfil padrão. No entanto, é atípico associar mais de um perfil a um scanner.

AssociateColorProfileWithDevice sempre adiciona o perfil especificado à lista de associação de perfil por usuário do usuário atual para o dispositivo especificado. Antes de adicionar o perfil à lista, AssociateColorProfileWithDevice determina se o usuário já expressou o desejo de usar uma lista de associação de perfil por usuário para o dispositivo. Nesse caso, AssociateColorProfileWithDevice simplesmente adiciona o perfil especificado à lista de associação de perfil por usuário existente para o dispositivo. Caso contrário, AssociateColorProfileWithDevice cria uma nova lista de associação de perfil por usuário para o dispositivo copiando a lista de associações em todo o sistema para esse dispositivo. Em seguida, acrescenta o perfil especificado à lista por usuário. A partir daí, o usuário atual usará uma lista de associação de perfil por usuário para o dispositivo especificado, como se WcsSetUsePerUserProfiles tivesse sido chamado para pDevice com o parâmetro usePerUserProfiles definido como TRUE.

Requisitos

   
Cliente mínimo com suporte Windows 10 Build 20348
Servidor mínimo com suporte Windows 10 Build 20348
Cabeçalho icm.h

Confira também