Função GetColorProfileElement (icm.h)

  • Artigo

Copia dados de um elemento de perfil marcado especificado de um perfil de cor especificado em um buffer.

Sintaxe

BOOL GetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement,
  PBOOL    pbReference
);

Parâmetros

hProfile

Especifica um identificador para o perfil de cores do ICC (International Color Consortium) em questão.

tag

Identifica o elemento marcado do qual copiar.

dwOffset

Especifica o deslocamento do primeiro byte dos dados do elemento marcado no qual começar a copiar.

pcbElement

Ponteiro para uma variável que especifica o número de bytes a serem copiados. No retorno, a variável contém o número de bytes realmente copiados.

pElement

Ponteiro para um buffer no qual os dados do elemento marcado devem ser copiados. O buffer deve conter pelo menos quantos bytes forem especificados pela variável apontada por pcbSize. Se o ponteiro pBuffer for definido como NULL, o tamanho de todos os dados de elemento marcados em bytes será retornado no local de memória apontado por pcbSize e dwOffset será ignorado. Nesse caso, a função retornará FALSE.

pbReference

Aponta para um valor booliano definido como TRUE se mais de uma marca no perfil de cor se referir aos mesmos dados aos quais a marca especificada se refere ou FALSE , caso contrário.

Valor retornado

Se essa função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

Essa função falhará se hProfile não for um perfil válido do ICC (International Color Consortium).

Se o ponteiro pBuffer for definido como NULL, o tamanho de todos os dados do elemento marcado em bytes será retornado na variável apontada por pcbSize e dwOffset será ignorado.

Essa função não dá suporte a perfis do WCS (Sistema de Cores do Windows) CAMP, DMP e GMMP; porque os elementos de perfil são implicitamente associados e embutidos em código para tipos de marca ICC e existem muitas bibliotecas de análise XML robustas.

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