Método IWICBitmapCodecInfo::GetColorManagementVersion (wincodec.h)

Recupera o número de versão de gerenciamento de cores compatível com o codec.

Sintaxe

HRESULT GetColorManagementVersion(
  [in]      UINT  cchColorManagementVersion,
  [in, out] WCHAR *wzColorManagementVersion,
  [in, out] UINT  *pcchActual
);

Parâmetros

[in] cchColorManagementVersion

Tipo: UINT

O tamanho do buffer de versão. Use 0 na primeira chamada para determinar o tamanho necessário do buffer.

[in, out] wzColorManagementVersion

Tipo: WCHAR*

Recebe o número da versão de gerenciamento de cores. Use NULL na primeira chamada para determinar o tamanho necessário do buffer.

[in, out] pcchActual

Tipo: UINT*

O tamanho real do buffer necessário para recuperar o número de versão de gerenciamento de cores completo.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O padrão de uso para esse método é um processo de duas chamadas. A primeira chamada recupera o tamanho do buffer necessário para recuperar o número de versão de gerenciamento de cores completo chamando-o com cchColorManagementVersion definido como 0 e wzColorManagementVersion definido como NULL. Essa chamada define pcchActual para o tamanho do buffer necessário. Depois que o tamanho do buffer necessário for determinado, uma segunda chamada GetColorManagementVersion com cchColorManagementVersion definida como o tamanho do buffer e wzColorManagementVersion definido como um buffer do tamanho apropriado recuperará os formatos de pixel.

Requisitos

Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
Biblioteca	Windowscodecs.lib
DLL	Windowscodecs.dll