Compartilhar via

Método IApoAuxiliaryInputConfiguration::IsInputFormatSupported (audioenginebaseapo.h)

  • Artigo

Verifica se um formato de entrada auxiliar específico tem suporte do APO.

Sintaxe

HRESULT IsInputFormatSupported(
  IAudioMediaType *pRequestedInputFormat,
  IAudioMediaType **ppSupportedInputFormat
);

Parâmetros

pRequestedInputFormat

O formato de entrada que deve ser verificado.

ppSupportedInputFormat

O APO preenche esse parâmetro com o formato de entrada com suporte mais próximo do formato passado para o método .

Retornar valor

HRESULT

HRESULT Descrição
S_OK Conclusão bem-sucedida. O APO deve adicionar uma referência a pRequestedInputFormat e retorná-la em ppSupportedInputFormat
S_FALSE Não há suporte para formato. O APO deve retornar um formato sugerido com suporte em ppSupportedInputFormat
APOERR_FORMAT_NOT_SUPPORTED Não há suporte para formato. O APO não deve modificar ppSupportedInputFormat
E_POINTER Ponteiro inválido passado para essa função.
Outros valores Outro componente está causando uma falha. Essas falhas são controladas pelo sistema.

Comentários

Se o APO puder aceitar o formato solicitado, ele deverá adicionar uma referência ao formato solicitado, retornar isso como o formato de saída com suporte e retornar S_OK.

Se o APO não puder aceitar o formato solicitado, ele poderá sugerir um formato alternativo solicitado. Nesse caso, ele deve criar e retornar o formato sugerido e retornar S_FALSE.

O formato com suporte retornado deve ser "mais próximo" do formato solicitado, o que significa que o formato deve ter os mesmos valores para as propriedades a seguir, especificados na ordem de prioridade.

  • formato de exemplo
  • profundidade de bits
  • número de canais
  • taxa de amostragem

O formato sugerido só poderá ser diferente do formato solicitado se S_FALSE for retornado. Ao retornar qualquer falha, o formato sugerido deve ser deixado intocado.

Essa API pode ser chamada a qualquer momento. Os resultados retornados dependerão do estado interno do APO que pode ser manipulado por interfaces do usuário externas. No entanto, depois que o APO estiver bloqueado para processamento, esse formato não poderá e não será alterado.

Esse método pode não ser chamado de um thread de processamento em tempo real.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 Build 20348
Cabeçalho audioenginebaseapo.h