Compartilhar 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, 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.

Valor de retorno

Se essa função for bem-sucedida, o valor retornado será VERDADEIRO. 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.

Observações

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 atualmente sendo usado 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 contexto de dispositivo (DC) 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 no Windows 95/98/Me Systems.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho wingdi.h
biblioteca Gdi32.lib
de DLL Gdi32.dll

Consulte também