Share via

Função GetStandardColorSpaceProfileW (icm.h)

  • Artigo

Recupera o perfil de cor registrado para o espaço de cor padrão especificado.

Sintaxe

BOOL GetStandardColorSpaceProfileW(
  PCWSTR pMachineName,
  DWORD  dwSCS,
  PWSTR  pBuffer,
  PDWORD pcbSize
);

Parâmetros

pMachineName

Reservado. Deve ser NULL. Esse parâmetro destina-se a apontar para o nome do computador no qual obter um perfil de espaço de cor padrão. Um ponteiro NULL indica o computador local.

dwSCS

Especifica o valor da ID do espaço de cor padrão para o qual recuperar o perfil. Os únicos valores válidos para esse parâmetro são LCS_sRGB e LCS_WINDOWS_COLOR_SPACE.

pBuffer

Ponteiro para o buffer no qual o nome do perfil deve ser colocado. Se FOR NULL, a chamada retornará TRUE e o tamanho necessário do buffer será colocado em pdwSize.

pcbSize

Ponteiro para uma variável que contém o tamanho em bytes do buffer apontado por pProfileName. No retorno, a variável contém o tamanho do buffer realmente usado ou necessário.

Valor retornado

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

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

Comentários

Se o buffer apontado por pProfileName for alocado dinamicamente por um aplicativo, o aplicativo poderá chamar a função GetStandardColorSpaceProfile para recuperar o tamanho necessário para o buffer. Se GetStandardColorSpaceProfile for chamado com pProfileName definido como NULL, ele retornará FALSE e o DWORD apontado por pdwSize conterá o número de bytes necessários para o buffer apontado por pProfileName. Em seguida, o aplicativo pode alocar o buffer e chamar GetStandardColorSpaceProfile novamente com pProfileName definido como o endereço do buffer.

Essa função dá suporte a DMPs (perfis de modelo de dispositivo) do WCS (Sistema de Cores do Windows), além de perfis do ICC (International Color Consortium). Ele não dá suporte a perfis WCS CAMP ou GMMP e retornará um erro se esses perfis forem usados.

Visão geral da funcionalidade específica do Windows Vista

Isso dará suporte a DMPs do WCS, além de perfis ICC. Ele não dará suporte a perfis WCS CAMP ou GMMP e retornará um erro se esses perfis forem usados com essa API.

Suporte por usuário/LUA

Isso recuperará o perfil de cor registrado para o espaço de cor padrão especificado para o usuário atual. Se não houver essa configuração para o usuário atual, ela recuperará a configuração de todo o sistema.

Isso usa WcsGetDefaultColorProfile com WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER.

Isso é executável no contexto LUA.

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