Compartilhar via


Função GetColorProfileFromHandle (icm.h)

Dado um identificador para um perfil de cor aberta, a função GetColorProfileFromHandle copia o conteúdo do perfil em um buffer fornecido pelo aplicativo. Se o identificador for um identificador do WCS (Sistema de Cores do Windows), o DMP será retornado e o CAMP e o GMMP associados ao HPROFILE serão ignorados.

Sintaxe

BOOL GetColorProfileFromHandle(
  HPROFILE hProfile,
  PBYTE    pProfile,
  PDWORD   pcbProfile
);

Parâmetros

hProfile

Manipule para um perfil de cor aberta. A função determina se o HPROFILE contém informações de perfil ICC ou WCS.

pProfile

Ponteiro para buffer para receber dados brutos de perfil ICC ou DMP. Pode ser NULL. Se for, o tamanho necessário para o buffer será armazenado no local de memória apontado por pcbSize. O buffer pode ser alocado para o tamanho apropriado e essa função é chamada novamente com pBuffer contendo o endereço do buffer.

pcbProfile

Ponteiro para um DWORD que contém o tamanho do buffer apontado por pBuffer. No retorno, ele é preenchido com o tamanho do buffer que foi realmente usado se a função for bem-sucedida. Se essa função for chamada com pBuffer definido como NULL, esse parâmetro conterá o tamanho do buffer necessário.

Valor retornado

Se essa função for bem-sucedida, o valor retornado será TRUE. Ele retornará FALSE se o parâmetro pBuffer for NULL e o tamanho necessário para o buffer for copiado para pcbSize.

Se essa função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

   
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]
Cabeçalho icm.h
Biblioteca Mscms.lib
DLL Mscms.dll

Confira também