|
|
|
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).
| Get | Set | Target | Property Descriptor Type | Property Value Type |
|---|---|---|---|---|
| Yes | Yes | Pin | KSNODEPROPERTY | 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.
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.
Declared in ksmedia.h. Include ksmedia.h.
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.