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
);

Parameters

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.

Valor de devolução

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.

Observações

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 for mais necessário ou haverá um vazamento de memória. Use a função GlobalHandle para recuperar o identificador do buffer e, em seguida, use a função GlobalFree para liberar o identificador.

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

Requirements

Consulte também

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