Função EnumICMProfilesA (wingdi.h)
A função EnumICMProfiles enumera os diferentes perfis de cor de saída aos quais o sistema dá suporte para um determinado contexto de dispositivo.
Sintaxe
int EnumICMProfilesA(
HDC hdc,
ICMENUMPROCA 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.
Valor retornado
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 é 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 em Sistemas Windows 95/98/Me.
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
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 |