Função CMGetInfo (icm.h)
Recupera várias informações sobre o CMM (módulo de gerenciamento de cores).
Cada CMM é necessário para exportar essa função.
Sintaxe
DWORD CMGetInfo(
DWORD dwInfo
);
Parâmetros
dwInfo
Especifica quais informações devem ser recuperadas. Esse parâmetro pode ter um dos seguintes valores constantes.
| Constante | Significância do valor retornado da função |
|---|---|
| CMM_DESCRIPTION | Uma cadeia de caracteres de texto que descreve o módulo de gerenciamento de cores. |
| CMM_DLL_VERSION | Número de versão da DLL do CMM. |
| CMM_DRIVER_LEVEL | Informações de compatibilidade do driver. |
| CMM_IDENT | A assinatura de identificação do CMM registrada no ICC (International Color Consortium). |
| CMM_LOGOICON | O ícone de logotipo deste CMM. |
| CMM_VERSION | Versão do Windows com suporte. |
| CMM_WIN_VERSION | Compatibilidade com versões anteriores com o Windows 95. |
Valor retornado
Se essa função for bem-sucedida, o valor retornado será o mesmo valor diferente de zero que foi passado por meio do parâmetro dwInfo . Se a função falhar, o valor retornado será zero.
Comentários
A função CMGetInfo pode ser chamada por aplicativos diretamente para obter informações sobre o CMM. Os aplicativos não devem chamar outras funções CMM diretamente. Para obter informações do CMM, obtenha o caminho para o CMM do registro. Invoque a função de API do Windows GetModuleHandle e passe o nome do arquivo do CMM como o valor de seu parâmetro. Chame a função CMGetInfo e passe a constante CMM_DESCRIPTION como o valor de seu parâmetro. Chame a função LoadString . Passe o identificador do módulo como o primeiro parâmetro e o valor retornado da função CMGetInfo como o valor do segundo parâmetro.
Os CMMs que não são executados no Windows 95 devem retornar 0x0050000 para CMM_WIN_VERSION.
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 |