Compartir a través de

Interfaz IApoAcousticEchoCancellation (audioenginebaseapo.h)

  • Artículo

Esta interfaz la implementan las API para habilitar escenarios de cancelación de eco acústico (AEC).

Herencia

La interfaz IApoAcousticEchoCancellation hereda de la interfaz IUnknown.

Comentarios

Esta interfaz solo se puede implementar mediante efectos de modo (MFX) en puntos de conexión de captura. La implementación de esta interfaz en cualquier otro APO provocará un error al cargar ese APO. Si el efecto de modo en un punto de conexión de captura se implementa como una serie de API encadenadas, solo el APO más cercano al dispositivo puede implementar esta interfaz.

La interfaz IApoAcousticEchoCancellation no tiene métodos explícitos en ella. Su propósito es identificar un APO de AEC en el motor de audio. Las API que implementan esta interfaz se pasarán a una estructura de APO_CONNECTION_PROPERTY_V2 en su llamada a IAudioProcessingObjectRT::APOProcess. APO_CONNECTION_PROPERTY_V2 proporciona una marca de tiempo para permitir que el APO sincronice los búferes de las secuencias principales y auxiliares. Si el campo u32Signature de la estructura de APO_CONNECTION_PROPERTY pasado a IAudioProcessingObjectRT::APOProcess es igual a APO_CONNECTION_PROPERTY_V2_SIGNATURE, la estructura se puede convertir de forma segura en una APO_CONNECTION_PROPERTY_V2.

Dado que los algoritmos AEC normalmente requieren velocidades de muestreo y recuentos de canales específicos, el motor de audio proporciona compatibilidad de remuestreo a las API que implementan la interfaz IApoAcousticEchoCancellation . El método IApoAuxiliaryInputConfiguration::IsInputFormatSupported proporciona un mecanismo para informar al sistema del formato de entrada preferido del APO devolviendo el APOERR_FORMAT_NOT_SUPPORTED HRESULT. y devuelven el formato solicitado en el parámetro ppSupportedInputFormat del método. Después, el motor de audio volverá a aplicar el audio de entrada al formato sugerido antes de enviarlo al APO de AEC. Esto elimina la necesidad de que el APO de AEC implemente la frecuencia de muestreo y la conversión del recuento de canales.

Requisitos

Requisito Value
Cliente mínimo compatible compilación 20348 de Windows 10
Encabezado audioenginebaseapo.h

Consulte también

APO_CONNECTION_PROPERTY_V2IAudioProcessingObjectRT::APOProcessIAudioProcessingObject::IsInputFormatSupported