Share via

Função CreateDeviceLinkProfile (icm.h)

  • Artigo

Cria um perfil de link de dispositivo do ICC (International Color Consortium) com base em um conjunto de perfis de cores, usando as intenções especificadas.

Sintaxe

BOOL CreateDeviceLinkProfile(
  PHPROFILE hProfile,
  DWORD     nProfiles,
  PDWORD    padwIntent,
  DWORD     nIntents,
  DWORD     dwFlags,
  PBYTE     *pProfileData,
  DWORD     indexPreferredCMM
);

Parâmetros

hProfile

Ponteiro para uma matriz de identificadores dos perfis de cor a serem usados. A função determina se os HPROFILEs contêm informações de perfil ICC e, nesse caso, processa-os adequadamente.

nProfiles

Especifica o número de perfis na matriz apontada por hProfile.

padwIntent

Ponteiro para uma matriz de DWORDS que contém as intenções a serem usadas. Confira Intenções de renderização.

nIntents

O número de intenções na matriz apontada por padwIntent.

dwFlags

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

pProfileData

Ponteiro para um ponteiro para um buffer. Se tiver êxito, essa função alocará o buffer, colocará seu endereço em *pProfileData e o preencherá com um perfil de link do dispositivo. Se a função for bem-sucedida, o aplicativo de chamada deverá liberar o buffer depois que ele não for mais necessário.

indexPreferredCMM

Especifica o índice baseado em um do perfil de cor que indica qual cmm (módulo de gerenciamento de cores) usar. O desenvolvedor de aplicativos pode permitir que o Windows escolha o CMM definindo esse parâmetro como INDEX_DONT_CARE. Consulte Usando módulos de gerenciamento de cores (CMM).

Valor retornado

Se essa função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se essa função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para HPROFILEs que contêm informações de perfil do WCS, os HPROFILEs são convertidos em identificadores de perfil ICC válidos e, em seguida, esses identificadores de perfil ICC são usados na criação do perfil de link do dispositivo.

O primeiro e o último perfis na matriz devem ser perfis de dispositivo. Os outros perfis podem ser espaços de cores ou perfis abstratos.

O espaço de cor de saída de cada perfil deve ser o espaço de cor de entrada do próximo perfil.

O aplicativo de chamada deve liberar o buffer alocado por essa função e apontado pelo parâmetro pProfileData . A função GlobalFree deve ser usada para liberar o buffer.

Requisitos

   
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