Share via

Função GetICMProfileA (wingdi.h)

  • Artigo

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 GetICMProfileA(
  HDC     hdc,
  LPDWORD pBufSize,
  LPSTR   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, no retorno, 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 ou não habilitado 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 em Microsoft Layer for Unicode em Sistemas Windows 95/98/Me.

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

Confira também