|
|
|
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).
| Get | Set | Target | Property Descriptor Type | Property Value Type |
|---|---|---|---|---|
| Yes | Yes | Pin | KSNODEPROPERTY | ULONG |
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.
The default is pass-through mode. When the filter containing the AEC node is created or the node is reset, the node is initially configured 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.
Declared in ksmedia.h. Include ksmedia.h.