KSPROPERTY_AEC_NOISE_FILL_ENABLE
The KSPROPERTY_AEC_NOISE_FILL_ENABLE property is used to enable and disable background noise filling. This is an optional property of an AEC node (KSNODETYPE_ACOUSTIC_ECHO_CANCEL).
Usage Summary Table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
Yes |
Yes |
Pin |
BOOL |
The property value (operation data) is of type BOOL. Setting this value to TRUE enables background noise filling. When enabled, the node inserts background noise into the capture stream. Setting this value to FALSE disables background noise filling.
Return Value
A KSPROPERTY_AEC_NOISE_FILL_ENABLE property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.
Remarks
An AEC node inserts background comfort noise into the capture stream in order to avoid the unnatural silence that occurs when the captured data stream is set to zero after perfect echo cancellation.
When the filter containing the AEC node is created or the node is reset, background noise filling is disabled by default.
Requirements
Header |
Ksmedia.h (include Ksmedia.h) |