Método IAudioProcessingObjectPreferredFormatSupport::GetPreferredInputFormat (audioengineextensionapo.h)

Função de retorno de chamada que permite que as APOs especifiquem um formato de entrada preferencial para o formato de saída fornecido.

Sintaxe

HRESULT GetPreferredInputFormat(
  [in]  IAudioMediaType *outputFormat,
  [out] IAudioMediaType **preferredFormat
);

Parâmetros

[in] outputFormat

Um IAudioMediaType que representa o formato de saída associado ao retorno de chamada.

[out] preferredFormat

Um IAudioMediaType que representa o formato de entrada preferencial para o APO.

Retornar valor

Um HRESULT.

Comentários

Essa API permite cenários como um provedor de fones de ouvido que fornece som surround virtual. O APO pode solicitar o recebimento de entrada 7-1, mesmo que o ponto de extremidade seja renderizado em estéreo. As APOs podem especificar formatos preferenciais diferentes para formatos de saída diferentes. Por exemplo, um aplicativo pode solicitar entrada 7.1 quando o tipo de fluxo m for mídia, mas solicitar entrada estéreo quando o tipo de fluxo for comunicações.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 11, versão 23H2
Cabeçalho	audioengineextensionapo.h