Função AssociateColorProfileWithDeviceA (icm.h)
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 |