Share via


Função CMGetPS2ColorRenderingIntent (icm.h)

Recupera a intenção de renderização de cores de Nível 2 do PostScript de um perfil.

Sintaxe

BOOL CMGetPS2ColorRenderingIntent(
  HPROFILE hProfile,
  DWORD    dwIntent,
  LPBYTE   lpBuffer,
  LPDWORD  lpcbSize
);

Parâmetros

hProfile

Especifica o perfil a ser usado.

dwIntent

Especifica a intenção de renderização desejada a ser recuperada. Pode ser um dos seguintes valores:

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

Para obter mais informações, consulte Renderizando intenções.

lpBuffer

Aponta para um buffer no qual a intenção de renderização de cor deve ser colocada. Se o ponteiro for NULL, a função retornará o tamanho necessário para esse buffer em *lpcbSize.

lpcbSize

Aponta para uma variável que especifica o tamanho do buffer. No retorno, a variável contém o número de bytes realmente copiados para o buffer.

Retornar valor

Se essa função for bem-sucedida, o valor retornado será TRUE. Ele também retornará TRUE se for chamado com lpBuffer definido como NULL e o tamanho do buffer necessário for copiado para lpcbSize.

Se essa função falhar, o valor retornado será FALSE. Quando isso ocorre, o CMM deve chamar SetLastError para definir o último erro como um valor de erro válido definido em Winerror.h.

Comentários

Essa função é opcional para todos os CMMs.

Se um CMM não der suporte a essa função, o Windows usará o CMM padrão para obter a intenção de renderização de cores.

Se a marca não estiver presente no perfil indicado por hProfile, o CMM a criará. A intenção de renderização resultante pode ser usada como o operando para o operador findcolorrendering de Nível 2 do PostScript.

Requisitos

Requisito Valor
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

Confira também