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
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
- conceitos básicos de gerenciamento de cores
- Funções
- EnumICMProfilesW
- SetICMProfileW