Função CMCreateProfile (icm.h)

[CMCreateProfile não está mais disponível para uso a partir do Windows Vista.]

Cria um perfil de cor de exibição a partir de uma estrutura LOGCOLORSPACEA .

Sintaxe

BOOL CMCreateProfile(
  LPLOGCOLORSPACEA lpColorSpace,
  LPDEVCHARACTER   *lpProfileData
);

Parâmetros

lpColorSpace

Ponteiro para um espaço lógico de cor, do qual o membro lcsFilename será NULL.

lpProfileData

Ponteiro para um ponteiro para um buffer. Se bem-sucedida, a função aloca e preenche esse buffer. É responsabilidade do aplicativo de chamada liberar esse buffer quando ele não for mais necessário.

Valor de retorno

A partir do Windows Vista, o CMM padrão (Icm32.dll) retornará FALSE e GetLastError relatará ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP e Windows 2000:

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

Se essa função falhar, o valor retornado será FALSE. Chame GetLastError para recuperar o erro.

Observações

A partir do Windows Vista, os implementadores de CMM não são mais necessários para implementar esse método.

Windows Server 2003, Windows XP e Windows 2000:

A versão Unicode dessa função é CMCreateProfileW.

Somente o CMM padrão do Windows é necessário para exportar essa função; é opcional para todos os outros CMMs.

Se um CMM não der suporte a CMCreateProfile, o Windows usará o CMM padrão para criar o perfil.

O CMM deve definir todos os campos de cabeçalho como padrões sensatos. Esse perfil deve ser utilizável como o perfil de entrada em uma transformação.

O aplicativo de chamada deve liberar o buffer alocado por essa função e apontado pelo parâmetro lpProfileData . Use o GlobalFree para liberar o buffer.

Requirements

Consulte também

• Conceitos básicos de gerenciamento de cores
• Funções
• CMCreateProfileW