Share via


Função CMCreateTransformExt (icm.h)

Cria uma transformação de cores que mapeia de um LOGCOLORSPACEA de entrada para um espaço de destino opcional e, em seguida, para um dispositivo de saída, usando um conjunto de sinalizadores que definem como a transformação deve ser criada.

Sintaxe

HCMTRANSFORM CMCreateTransformExt(
  LPLOGCOLORSPACEA lpColorSpace,
  LPDEVCHARACTER   lpDevCharacter,
  LPDEVCHARACTER   lpTargetDevCharacter,
  DWORD            dwFlags
);

Parâmetros

lpColorSpace

Ponteiro para uma estrutura de espaço de cor lógica de entrada.

lpDevCharacter

Ponteiro para um perfil de dispositivo mapeado pela memória.

lpTargetDevCharacter

Ponteiro para um perfil de destino mapeado pela memória.

dwFlags

Especifica sinalizadores para a criação do controle usado da transformação. Para obter detalhes, confira Sinalizadores de criação de transformação do CMM.

Retornar valor

Se essa função for bem-sucedida, o valor retornado será uma transformação de cor no intervalo de 256 a 65.535. Como apenas o WORD baixo da transformação é mantido, transformações válidas não podem exceder esse intervalo.

Se essa função falhar, o valor retornado será um código de erro com um valor menor que 256. Quando o valor retornado for menor que 256, sinalizando um erro, o CMM deverá usar SetLastError para definir o último erro como um valor de erro válido, conforme definido em Winerror.h.

Comentários

O equivalente Unicode de CMCreateTransformExt é CMCreateTransformExtW.

Cada CMM é necessário para exportar essa função.

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