Função EnumICMProfilesW (wingdi.h)

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 EnumICMProfilesW(
  HDC          hdc,
  ICMENUMPROCW proc,
  LPARAM       param
);

Parâmetros

hdc

Especifica o contexto de 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.

Retornar valor

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 será o último valor retornado pela função de retorno de chamada.

Comentários

A função EnumICMProfiles retorna uma lista de perfis associados a um DC (contexto de dispositivo) 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 dispositivos de hardware específicos 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 .

O Windows 95/98/Me:EnumICMProfilesW tem suporte da Camada da Microsoft para Unicode. Para usar isso, você deve adicionar determinados arquivos ao seu aplicativo, conforme descrito no Microsoft Layer for Unicode no Windows 95/98/Me Systems.

Observação

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. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
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]
Plataforma de Destino Windows
Cabeçalho wingdi.h
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também