Compartilhar via

Método IWMDMDevice2::GetFormatSupport2 (mswmdm.h)

  • Artigo

O método GetFormatSupport2 recupera os formatos compatíveis com o dispositivo, incluindo codecs de áudio e vídeo e formatos de arquivo MIME.

Sintaxe

HRESULT GetFormatSupport2(
  [in]  DWORD              dwFlags,
  [out] _WAVEFORMATEX      **ppAudioFormatEx,
  [out] UINT               *pnAudioFormatCount,
  [out] _VIDEOINFOHEADER   **ppVideoFormatEx,
  [out] UINT               *pnVideoFormatCount,
  [out] WMFILECAPABILITIES **ppFileType,
  [out] UINT               *pnFileTypeCount
);

Parâmetros

[in] dwFlags

DWORD especificando formatos de áudio, formatos de vídeo e tipos MIME. Esse sinalizador especifica o que o aplicativo está solicitando que o provedor de serviços preencha. O chamador pode definir um ou mais dos três valores a seguir.

Valor Descrição
WMDM_GET_FORMAT_SUPPORT_AUDIO O provedor de serviços deve preencher parâmetros de áudio.
WMDM_GET_FORMAT_SUPPORT_VIDEO O provedor de serviços deve preencher parâmetros de vídeo.
WMDM_GET_FORMAT_SUPPORT_FILE O provedor de serviços deve preencher os parâmetros de arquivo.

[out] ppAudioFormatEx

Ponteiro para uma matriz de estruturas de _WAVEFORMATEX especificando informações sobre codecs de áudio e taxas de bits compatíveis com o dispositivo. A memória desse parâmetro é alocada pelo Windows Media Gerenciador de Dispositivos e deve ser liberada pelo chamador com a função Win32 CoTaskMemFree.

[out] pnAudioFormatCount

Ponteiro para um inteiro que especifica a contagem de formato de áudio.

[out] ppVideoFormatEx

Ponteiro para uma matriz de estruturas de _VIDEOFORMATEX especificando informações sobre códigos de vídeo e formatos compatíveis com o dispositivo. A memória desse parâmetro é alocada pelo Windows Media Gerenciador de Dispositivos e deve ser liberada pelo chamador com a função Win32 CoTaskMemFree.

[out] pnVideoFormatCount

Ponteiro para um inteiro que especifica a contagem de formato de vídeo.

[out] ppFileType

Ponteiro para uma matriz de objetos do tipo de arquivo WMFILECAPABILITIES . A memória desse parâmetro é alocada pelo Windows Media Gerenciador de Dispositivos e deve ser liberada pelo chamador com a função Win32 CoTaskMemFree.

[out] pnFileTypeCount

Ponteiro para um inteiro que especifica a contagem de tipo de arquivo.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

  • Códigos de erro COM padrão
  • Códigos de erro do Windows convertidos em valores HRESULT
  • Códigos de erro de Gerenciador de Dispositivos do Windows Media
Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Esse método estende IWMDMDevice::GetFormatSupport para manipular formatos de vídeo. No entanto, o método recomendado para obter suporte ao formato é IWMDMDevice3::GetFormatCapability. Se GetFormatCapability não tiver suporte, o dispositivo provavelmente não dará suporte a vídeo e GetFormatSupport provavelmente será suficiente.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

Descobrindo recursos de formato de dispositivo

IWMDMDevice2 Interface

IWMDMDevice3::GetFormatCapability