Share via

Função WcsGetDefaultColorProfileSize (icm.h)

  • Artigo

Retorna o tamanho, em bytes, do nome do perfil de cor padrão (incluindo o terminador NULL ), para um dispositivo.

Observação

Essa API não dá suporte a perfis de "cor avançada" para monitores HDR. Use ColorProfileGetDisplayDefault para gerenciar perfis de cores avançados.

Sintaxe

BOOL WcsGetDefaultColorProfileSize(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  PDWORD                       pcbProfileName
);

Parâmetros

scope

Um valor WCS_PROFILE_MANAGEMENT_SCOPE que especifica o escopo dessa operação de gerenciamento de perfil.

pDeviceName

Um ponteiro para o nome do dispositivo para o qual o perfil de cor padrão deve ser obtido. Se FOR NULL, um perfil padrão independente do dispositivo será usado.

cptColorProfileType

Um valor COLORPROFILETYPE que especifica o tipo de perfil de cor.

cpstColorProfileSubType

Um valor COLORPROFILESUBTYPE que especifica o subtipo de perfil de cor.

dwProfileID

A ID do espaço de cor que o perfil de cor representa.

pcbProfileName

Um ponteiro para um local que recebe o tamanho, em bytes, do nome do caminho do perfil de cor padrão, incluindo o terminador NULL .

Retornar valor

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

Use essa função para retornar o tamanho necessário do buffer apontado pelo parâmetro pProfileName na função WcsGetDefaultColorProfile .

Essa função é executável no contexto da conta de usuário (LUA) Least-Privileged.

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