The KSPROPERTY_AEC_MODE property is used to control an AEC node's mode of operation. 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|
The property value (operation data) is of type ULONG and can be set to one of the following mode constants from header file Ksmedia.h:
In pass-through mode, the AEC node allows capture and render data to simply pass through the node without being modified.
The AEC algorithm is running in half-duplex mode, which is similar in operation to a speaker phone. In this mode, the speaker volume is muted whenever the local person's speech has a higher volume level than the remote person's.
The AEC algorithm is running in full-duplex mode.
Pass-through mode is the default. When the filter containing the AEC node is created or the node is reset, the node is initially configured to operate in pass-through mode.
In the initial release of Windows XP, the AEC algorithm that the AEC system filter uses does not support the half-duplex mode.
A KSPROPERTY_AEC_MODE property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.
|Ksmedia.h (include Ksmedia.h)|