Interface IApoAcousticEchoCancellation (audioenginebaseapo.h)

Essa interface é implementada por APOs para habilitar cenários de cancelamento de eco acústico (AEC).

Herança

A interface IApoAcousticEchoCancellation herda da interface IUnknown.

Comentários

Essa interface só pode ser implementada por efeitos de modo (MFX) em pontos de extremidade de captura. Implementar essa interface em qualquer outro APO levará a uma falha no carregamento desse APO. Se o efeito de modo em um ponto de extremidade de captura for implementado como uma série de APOs encadeados, somente o APO mais próximo do dispositivo poderá implementar essa interface.

A interface IApoAcousticEchoCancellation não tem métodos explícitos. Sua finalidade é identificar um APO do AEC para o mecanismo de áudio. ApOs que implementam essa interface serão passados uma estrutura APO_CONNECTION_PROPERTY_V2 em sua chamada para IAudioProcessingObjectRT::APOProcess. APO_CONNECTION_PROPERTY_V2 fornece um carimbo de data/hora para permitir que o APO sincronize buffers dos fluxos primário e auxiliar. Se o campo u32Signature da estrutura APO_CONNECTION_PROPERTY passado para IAudioProcessingObjectRT::APOProcess for igual a APO_CONNECTION_PROPERTY_V2_SIGNATURE, a estrutura poderá ser tipada com segurança para um APO_CONNECTION_PROPERTY_V2.

Como os algoritmos AEC normalmente exigem taxas de amostragem específicas e contagens de canais, o mecanismo de áudio fornece suporte de resampling para APOs que implementam a interface IApoAcousticEchoCancellation . O método IApoAuxiliaryInputConfiguration::IsInputFormatSupported fornece um mecanismo para informar o sistema do formato de entrada preferencial do APO retornando a APOERR_FORMAT_NOT_SUPPORTED HRESULT. e retornando o formato solicitado no parâmetro ppSupportedInputFormat do método. Em seguida, o mecanismo de áudio resamplará o áudio de entrada para o formato sugerido antes de enviá-lo para o APO do AEC. Isso elimina a necessidade de o APO do AEC implementar a taxa de amostragem e a conversão de contagem de canais.

Requisitos

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

Confira também

APO_CONNECTION_PROPERTY_V2IAudioProcessingObjectRT::APOProcessIAudioProcessingObject::IsInputFormatSupported