Condividi tramite

Interfaccia IApoAcousticEchoCancellation (audioenginebaseapo.h)

  • Articolo

Questa interfaccia viene implementata dalle API per abilitare scenari di annullamento dell'eco acustico (AEC).

Ereditarietà

L'interfaccia IApoAcousticEchoCancellation eredita dall'interfaccia IUnknown.

Commenti

Questa interfaccia può essere implementata solo dagli effetti della modalità (MFX) sugli endpoint di acquisizione. L'implementazione di questa interfaccia in qualsiasi altro APO comporterà un errore durante il caricamento dell'APO. Se l'effetto della modalità su un endpoint di acquisizione viene implementato come una serie di API concatenati, solo l'APO più vicino al dispositivo può implementare questa interfaccia.

L'interfaccia IApoAcousticEchoCancellation non ha metodi espliciti su di esso. Il suo scopo è identificare un AEC APO al motore audio. Le API che implementano questa interfaccia verranno passate una struttura APO_CONNECTION_PROPERTY_V2 nella chiamata a IAudioProcessingObjectRT::APOProcess. APO_CONNECTION_PROPERTY_V2 fornisce un timestamp per consentire all'APO di sincronizzare i buffer dai flussi primari e ausiliari. Se il campo u32Signature della struttura APO_CONNECTION_PROPERTY passato a IAudioProcessingObjectRT::APOProcess è uguale a APO_CONNECTION_PROPERTY_V2_SIGNATURE, la struttura può essere digitata in modo sicuro in un APO_CONNECTION_PROPERTY_V2.

Poiché gli algoritmi AEC richiedono in genere frequenza di campionamento e conteggi dei canali specifici, il motore audio fornisce il supporto per le API che implementano l'interfaccia IApoAcousticEchoCancellation . Il metodo IApoAuxiliaryInputConfiguration::IsInputFormatSupported fornisce un meccanismo per informare il sistema del formato di input preferito dell'APO restituendo il APOERR_FORMAT_NOT_SUPPORTED HRESULT. e restituisce il formato richiesto nel parametro ppSupportedInputFormat del metodo. Il motore audio ricampionerà quindi l'audio di input al formato suggerito prima di inviarlo all'APO di AEC. Ciò elimina la necessità dell'APO AEC di implementare la frequenza di campionamento e la conversione del conteggio dei canali.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 Build 20348
Intestazione audioenginebaseapo.h

Vedi anche

APO_CONNECTION_PROPERTY_V2IAudioProcessingObjectRT::APOProcess IAudioProcessingObject::IsInputFormatSupported