Método IMDSPDevice3::GetFormatCapability (mswmdm.h)

Artigo
03/05/2024

O método GetFormatCapability recupera informações de um dispositivo sobre os valores ou intervalos de valores compatíveis com o dispositivo para cada aspecto de um formato de objeto específico.

Sintaxe

HRESULT GetFormatCapability(
  [in]  WMDM_FORMATCODE        format,
  [out] WMDM_FORMAT_CAPABILITY *pFormatSupport
);

Parâmetros

[in] format

WMDM_FORMATCODE

Valor enumerado que representa o formato de consulta.

[out] pFormatSupport

Retornada WMDM_FORMAT_CAPABILITY estrutura que contém os valores ou intervalos de valores com suporte para cada aspecto de um formato de objeto específico.

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 do Windows Media Gerenciador de Dispositivos

Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Esse método pode ser chamado para qualquer um dos formatos com suporte. A lista de formatos com suporte é representada por g_wszWMDMFormatsSupported propriedade do dispositivo.

Para um formato específico, esse método deve retornar todas as configurações de propriedades com suporte (por exemplo, combinações de taxa de bits e taxa de amostragem). Essas informações são expressas como uma funcionalidade de formato. Para obter informações detalhadas, consulte WMDM_FORMAT_CAPABILITY.