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

GetSetTargetProperty descriptor typeProperty 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.

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)

See also

KSNODEPROPERTY
KSNODETYPE_ACOUSTIC_ECHO_CANCEL

 

 

Send comments about this topic to Microsoft

Show: