Função EnumColorProfilesW (icm.h)

Enumera todos os perfis que satisfazem os critérios de enumeração especificados.

Sintaxe

BOOL EnumColorProfilesW(
  PCWSTR     pMachineName,
  PENUMTYPEW pEnumRecord,
  PBYTE      pEnumerationBuffer,
  PDWORD     pdwSizeOfEnumerationBuffer,
  PDWORD     pnProfiles
);

Parâmetros

pMachineName

Reservado. Deve ser NULL. Esse parâmetro destina-se a apontar para o nome do computador no qual enumerar perfis. Um ponteiro NULL indica o computador local.

pEnumRecord

Ponteiro para uma estrutura que especifica os critérios de enumeração.

pEnumerationBuffer

Ponteiro para um buffer no qual os perfis devem ser enumerados. Uma cadeia de MULTI_SZ de nomes de perfil que satisfazem os critérios especificados em *pEnumRecord será colocada nesse buffer.

pdwSizeOfEnumerationBuffer

Ponteiro para uma variável que contém o tamanho do buffer apontado pelo pBuffer. No retorno, *pdwSize contém o tamanho do buffer realmente usado ou necessário.

pnProfiles

Ponteiro para uma variável que conterá, no retorno, o número de nomes de perfil realmente copiados para o buffer.

Valor de retorno

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.

Observações

Vários perfis normalmente são associados a impressoras, com base nos tipos de papel e tinta. Há um perfil padrão para cada dispositivo. Para perfis do ICC (International Color Consortium), a GDI seleciona a melhor entre os perfis associados ao ICC quando seu aplicativo cria um contexto de dispositivo (DC).

Não tente usar EnumColorProfiles para determinar o perfil padrão de um dispositivo. Em vez disso, crie um contexto de dispositivo para o dispositivo e invoque a função GetICMProfile . No Windows Vista e no Windows 7, a função WcsGetDefaultColorProfile também pode ser usada para determinar o perfil de cores padrão de um dispositivo.

Se o membro dwFields da estrutura do tipo ENUMTYPE apontado pelo parâmetro pEnumRecord for definido como ET_DEVICENAME, essa função enumerará todos os perfis de cor associados a todos os tipos de dispositivos anexados ao computador do usuário, independentemente da classe de dispositivo. Se o membro dwFields da estrutura apontada pelo parâmetro pEnumRecord for definido como ET_DEVICENAME ou ET_DEVICECLASS e uma classe de dispositivo for especificada no membro dwDeviceClass da estrutura, essa função só enumerará os perfis associados à classe de dispositivo especificada. Se o membro dwFields for definido apenas como ET_DEVICECLASS, a função EnumColorProfiles enumerará todos os perfis que podem ser associados a esse tipo de dispositivo.

Sempre que EnumColorProfiles estiver examinando os perfis associados a um dispositivo específico, os resultados dependem se o usuário optou por usar a lista de perfis em todo o sistema associados a esse dispositivo ou sua própria lista ("por usuário"). Chamar WcsSetUsePerUserProfiles com seu parâmetro usePerUserProfiles definido como TRUE faz com que chamadas futuras para EnumColorProfiles examinem apenas a lista de associações de perfil por usuário do usuário atual para o dispositivo especificado. Chamar WcsSetUsePerUserProfiles com seu parâmetro usePerUserProfiles definido como FALSE faz com que chamadas futuras para EnumColorProfiles examinem a lista de associações de perfil em todo o sistema para o dispositivo especificado. Se WcsSetUsePerUserProfiles nunca tiver sido chamado para o usuário atual, EnumColorProfiles examinará a lista em todo o sistema.

Seu aplicativo pode usar EnumColorProfiles para obter o tamanho do buffer no qual os perfis são enumerados. Ele deve chamar a função EnumColorProfiles com o parâmetro pBuffer definido como NULL. Quando a função retornar, o parâmetro pdwSize conterá o tamanho do buffer necessário em bytes. Seu programa pode usar essas informações para alocar o buffer de enumeração. Em seguida, ele pode invocar EnumColorProfiles novamente com o parâmetro pBuffer definido como o endereço do buffer.

Essa função fornecerá as informações para converter informações de DMP específicas do WCS para o registro EnumType herdado para habilitar a enumeração de perfil consistente. Os padrões serão os mesmos que o ICC se essas informações não estiverem presentes.

Suporte por usuário/LUA

A enumeração é específica para o usuário atual. Associações de dispositivos de usuário de todo o sistema e atuais são consideradas. Para a configuração de perfil padrão, as configurações atuais do usuário substituem as do sistema.

Requirements

Consulte também

• Conceitos básicos de gerenciamento de cores
• Funções
• GetICMProfile
• ENUMTYPEW