Compartilhar via


Função WcsEnumColorProfiles (icm.h)

Enumera perfis de cor associados a qualquer dispositivo, no escopo especificado.

Observação

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

Sintaxe

BOOL WcsEnumColorProfiles(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PENUMTYPEW                   pEnumRecord,
  PBYTE                        pBuffer,
  DWORD                        dwSize,
  PDWORD                       pnProfiles
);

Parâmetros

scope

Um valor WCS_PROFILE_MANAGEMENT_SCOPE especificando o escopo dessa operação de gerenciamento de perfil.

pEnumRecord

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

pBuffer

Um ponteiro para um buffer no qual os nomes de perfil devem ser enumerados. A função WcsEnumColorProfiles coloca, neste buffer, uma cadeia de caracteres MULTI_SZ que consiste em nomes de perfil que atendem aos critérios especificados em *pEnumRecord.

dwSize

Uma variável que contém o tamanho, em bytes, do buffer apontado por pBuffer. Veja os Comentários.

pnProfiles

Um ponteiro opcional para uma variável que recebe o número de nomes de perfil copiados para o buffer para o qual o pBuffer aponta. Pode ser NULL se essas informações não forem necessárias.

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 WcsEnumColorProfilesSize para recuperar o valor do parâmetro dwSize , que é o tamanho, em bytes, do buffer apontado pelo parâmetro pBuffer .

Se o parâmetro profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_SYSTEM_WIDE, somente as associações de perfis em todo o sistema ao dispositivo serão consideradas. Se profileManagementScope for WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, somente as associações por usuário para o usuário atual serão consideradas. Se WcsSetUsePerUserProfiles nunca tiver sido chamado para esse usuário ou se WcsSetUsePerUserProfiles tiver sido chamado recentemente para esse usuário com seu parâmetro usePerUserProfiles definido como FALSE, WCSEnumColorProfiles retornará uma lista vazia.

Se WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER (a configuração atual do usuário) estiver presente, ela substituirá o padrão de todo o sistema para o parâmetro profileManagementScope .

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

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