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

Recupera uma lista delimitada por vírgulas de modelos de dispositivo associados ao codec.

Sintaxe

HRESULT GetDeviceModels(
  [in]      UINT  cchDeviceModels,
  [in, out] WCHAR *wzDeviceModels,
  [in, out] UINT  *pcchActual
);

Parâmetros

[in] cchDeviceModels

Tipo: UINT

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

[in, out] wzDeviceModels

Tipo: WCHAR*

Recebe uma lista delimitada por vírgulas de nomes de modelo de dispositivo associados ao codec. Use NULL na primeira chamada para determinar o tamanho do buffer necessário.

[in, out] pcchActual

Tipo: UINT*

O tamanho real do buffer necessário para recuperar todos os nomes de modelo de dispositivo.

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 desse 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 cchDeviceModels definido 0 como e wzDeviceModels definido NULLcomo . Essa chamada define pcchActual para o tamanho do buffer necessário. Depois que o tamanho do buffer necessário for determinado, uma segunda chamada GetDeviceModels com cchDeviceModels definida como o tamanho do buffer e wzDeviceModels 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