Compartilhar via


Função CreateProfileFromLogColorSpaceW (icm.h)

Converte um espaço de cor lógica em um perfil de dispositivo.

Sintaxe

BOOL CreateProfileFromLogColorSpaceW(
  LPLOGCOLORSPACEW pLogColorSpace,
  PBYTE            *pProfile
);

Parâmetros

pLogColorSpace

Um ponteiro para uma estrutura de espaço de cor lógica. Consulte LOGCOLORSPACEA para obter detalhes. O membro lcsFilename [0] da estrutura deve ser definido como o caractere nulo ('\0') ou essa chamada de função falhará com o valor retornado de INVALID_PARAMETER.

pProfile

Um ponteiro para um ponteiro para um buffer em que o perfil do dispositivo será criado. Essa função aloca o buffer e o preenche com informações de perfil se ele for bem-sucedido. Caso contrário, o ponteiro será definido como NULL. O chamador é responsável por liberar esse buffer quando ele não é mais necessário.

Retornar valor

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

Se essa função falhar, o valor retornado será FALSE.

Se o membro lcsFilename [0] se a estrutura LOGCOLORSPACEA apontada por pLogColorSpace não for '\0', essa função retornará INVALID_PARAMETER.

Comentários

Essa função pode ser usada com cadeias de caracteres ASCII ou Unicode. O buffer criado por essa função deve ser liberado pelo chamador quando ele não é mais necessário ou haverá uma perda de memória. A função GlobalFree deve ser usada para liberar esse buffer.

Essa função não dá suporte a perfis do WCS (Sistema de Cores do Windows) CAMP, DMP e GMMP.

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
Biblioteca Mscms.lib
DLL Mscms.dll

Confira também