Função GetICMProfileW (wingdi.h)
A função GetICMProfile recupera o nome do arquivo do perfil de cor de saída atual para um contexto de dispositivo especificado.
Sintaxe
BOOL GetICMProfileW(
HDC hdc,
LPDWORD pBufSize,
LPWSTR pszFilename
);
Parâmetros
hdc
Especifica um contexto de dispositivo do qual recuperar o perfil de cor.
pBufSize
Ponteiro para um DWORD que contém o tamanho do buffer apontado por lpszFilename. Para a versão ANSI dessa função, o tamanho está em bytes. Para a versão Unicode, o tamanho está em WCHARs. Se essa função for bem-sucedida, ao retornar, esse parâmetro conterá o tamanho do buffer realmente usado. No entanto, se o buffer não for grande o suficiente, essa função retornará FALSE. Nesse caso, a função GetLastError() retorna ERROR_INSUFFICIENT_BUFFER e o DWORD apontado por esse parâmetro contém o tamanho necessário para o buffer lpszFilename .
pszFilename
Aponta para o buffer que recebe o nome do caminho do perfil.
Retornar valor
Se essa função for bem-sucedida, o valor retornado será TRUE. Ele também retornará TRUE se o parâmetro lpszFilename for NULL e o tamanho necessário para o buffer for copiado para lpcbName.
Se essa função falhar, o valor retornado será FALSE.
Comentários
GetICMProfile obtém o nome do arquivo do perfil de saída atual, independentemente de o gerenciamento de cores estar habilitado ou não para o contexto do dispositivo.
Dado um contexto de dispositivo, GetICMProfile produzirá, por meio do parâmetro lpszFilename, o nome do caminho do arquivo que contém o perfil de cor que está sendo usado atualmente pelo contexto do dispositivo. Ele também produzirá, por meio do parâmetro lpcbName, o comprimento da cadeia de caracteres que contém o nome do caminho.
É possível que o nome do perfil retornado por GetICMProfile não esteja na lista de perfis retornados por EnumICMProfiles. A função EnumICMProfiles retorna todos os perfis de espaço de cor associados a um DC (contexto de dispositivo) cujas configurações correspondem à do DC. Se a função SetICMProfile for usada para definir o perfil atual, um perfil poderá ser associado ao DC que não corresponde às configurações. Por exemplo, a função SetICMProfile pode ser usada para associar o perfil sRGB independente do dispositivo a um DC. Esse perfil será usado como o perfil atual do WCS para esse DC e as chamadas para GetICMProfile retornarão seu nome de arquivo. No entanto, o perfil não aparecerá na lista de perfis retornados de EnumICMProfiles.
Se essa função for chamada antes de qualquer chamada para a função SetICMProfile , ela poderá ser usada para obter o perfil padrão para um contexto de dispositivo.
Windows 95/98/Me: GetICMProfileW 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 GetICMProfile 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 |