IApoAcousticEchoCancellation 介面 (audioenginebaseapo.h)
此介面是由 AEC) 案例實作,以啟用聲場回音取消 (。
繼承
IApoAcousticEchoCancellation 介面繼承自 IUnknown 介面。
備註
此介面只能透過擷取端點上的 MFX) 模式 (效果來實作。 在任何其他 APO 上實作此介面會導致載入該 APO 失敗。 如果擷取端點上的模式效果實作為一系列鏈結的 APO,則只有最接近裝置的 APO 可以實作此介面。
IApoAcousticEchoCancellation 介面上沒有明確的方法。 其目的是要識別音訊引擎的 AEC APO。 實作此介面的 APO 將會在其呼叫 IAudioProcessingObjectRT::APOProcess 時傳遞APO_CONNECTION_PROPERTY_V2結構。 APO_CONNECTION_PROPERTY_V2 提供時間戳,讓 APO 能夠同步處理來自主要和輔助數據流的緩衝區。 如果傳遞至 IAudioProcessingObjectRT::APOProcess 之APO_CONNECTION_PROPERTY結構的 u32Signature 欄位等於APO_CONNECTION_PROPERTY_V2_SIGNATURE,則可以安全地將結構類型傳送至APO_CONNECTION_PROPERTY_V2。
因為 AEC 演算法通常需要特定的取樣率和通道計數,所以音訊引擎會針對實作 IApoAcousticEchoCancellation 介面的 APO 提供重新取樣支援。 IApoAuxiliaryInputConfiguration::IsInputFormatSupported 方法透過傳回 HRESULT APOERR_FORMAT_NOT_SUPPORTED,提供一種機制來通知系統 APO 慣用的輸入格式。 並傳回方法 ppSupportedInputFormat 參數中所要求的格式。 然後,音訊引擎會先將輸入音訊重新取樣為建議的格式,再將其傳送至 AEC APO。 這不需要 AEC APO 實作取樣率和通道計數轉換。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 組建 20348 |
標頭 | audioenginebaseapo.h |
另請參閱
APO_CONNECTION_PROPERTY_V2IAudioProcessingObjectRT::APOProcessIAudioProcessingObject::IsInputFormatSupported