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 NULL
como .
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 |