Compartilhar via

Função EnumICMProfilesA (wingdi.h)

  • Artigo

A função EnumICMProfiles enumera os diferentes perfis de cor de saída compatíveis com o sistema para um determinado contexto de dispositivo.

Sintaxe

int EnumICMProfilesA(
  HDC          hdc,
  ICMENUMPROCA proc,
  LPARAM       param
);

Parâmetros

hdc

Especifica o contexto do dispositivo.

proc

Especifica o endereço da instância de procedimento de uma função de retorno de chamada definida pelo aplicativo. (Consulte EnumICMProfilesProcCallback.)

param

Dados fornecidos pelo aplicativo que são passados para a função de retorno de chamada junto com as informações do perfil de cor.

Valor de retorno

Essa função retornará zero se o aplicativo interrompeu a enumeração. O valor retornado será -1 se não houver perfis de cor para enumerar. Caso contrário, o valor retornado é o último valor retornado pela função de retorno de chamada.

Observações

A função EnumICMProfiles retorna uma lista de perfis associados a um contexto de dispositivo (DC) e cujas configurações correspondem às do DC. É possível que um contexto de dispositivo contenha perfis de dispositivo que não estão associados a determinados dispositivos de hardware ou perfis de dispositivo que não correspondam às configurações do DC. O perfil sRGB é um exemplo. A função SetICMProfile é usada para associar esses tipos de perfis a um DC. A função GetICMProfile pode ser usada para recuperar um perfil que não é enumerado pela função EnumICMProfiles.

Windows 95/98/Me: EnumICMProfilesW é compatível com a Camada da Microsoft para Unicode. Para usar isso, você deve adicionar determinados arquivos ao seu aplicativo, conforme descrito em Microsoft Layer for Unicode no Windows 95/98/Me Systems.

Nota

O cabeçalho wingdi.h define EnumICMProfiles como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho wingdi.h
biblioteca Gdi32.lib
de DLL Gdi32.dll

Consulte também