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.

Requisitos

Confira também

• Conceitos básicos de gerenciamento de cores
• Funções
• EnumICMProfilesW
• SetICMProfileW