KSPROPERTY_AEC_MODE
La propriété KSPROPERTY_AEC_MODE est utilisée pour contrôler le mode de fonctionnement d’un nœud AEC. Il s’agit d’une propriété facultative d’un nœud AEC (KSNODETYPE_ACOUSTIC_ECHO_CANCEL).
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Oui |
Oui |
Épingle |
KSNODEPROPERTY | ULONG |
La valeur de propriété (données d’opération) est de type ULONG et peut être définie sur l’une des constantes de mode suivantes à partir du fichier d’en-tête Ksmedia.h :
AEC_MODE_PASS_THROUGH
En mode pass-through, le nœud AEC permet à la capture et au rendu des données de passer simplement par le nœud sans être modifiés.
AEC_MODE_HALF_DUPLEX
L’algorithme AEC s’exécute en mode demi-duplex, ce qui est similaire au fonctionnement d’un téléphone haut-parleur. Dans ce mode, le volume de l’orateur est désactivé chaque fois que la voix de la personne locale a un niveau de volume supérieur à celui de la personne distante.
AEC_MODE_FULL_DUPLEX
L’algorithme AEC s’exécute en mode duplex complet.
Le mode pass-through est la valeur par défaut. Lorsque le filtre contenant le nœud AEC est créé ou que le nœud est réinitialisé, le nœud est initialement configuré pour fonctionner en mode direct.
Dans la version initiale de Windows XP, l’algorithme AEC utilisé par le filtre système AEC ne prend pas en charge le mode demi-duplex.
Valeur de retour
Une demande de propriété KSPROPERTY_AEC_MODE retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la requête retourne une erreur appropriée status code.
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |