Compartilhar via


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 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 tiver êxito, a função alocará e preencherá esse buffer. É responsabilidade do aplicativo de chamada liberar esse buffer quando ele não for mais necessário.

Retornar valor

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.

Comentários

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 GlobalFree para liberar o buffer.

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