KSPROPERTY_TOPOLOGYNODE_ENABLE
La propriété KSPROPERTY_TOPOLOGYNODE_ENABLE est utilisée pour activer ou désactiver les nœuds de topologie dans une topologie déjà créée.
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Oui |
Oui |
Filtrer |
BOOL |
La valeur de propriété (données d’opération) est de type BOOL et spécifie si le nœud est activé ou désactivé. La valeur TRUE indique que le nœud est activé. FALSE indique que le nœud est désactivé.
Valeur de retour
Une demande de propriété KSPROPERTY_TOPOLOGYNODE_ENABLE 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.
Notes
L’activation d’un nœud déjà activé ou la désactivation d’un nœud déjà désactivé n’a aucun effet, mais ne doit pas être traitée comme une erreur.
La désactivation d’un nœud désactive la transformation que le nœud effectue sur le flux qui passe par le nœud. Dans le cas d’un nœud AEC, AGC ou de suppression du bruit (KSNODETYPE_ACOUSTIC_ECHO_CANCEL, KSNODETYPE_AGC ou KSNODETYPE_NOISE_SUPPRESS), par exemple, un nœud désactivé fonctionne en mode pass-through (autrement dit, il n’effectue aucune opération sur le flux car il circule de la broche d’entrée du nœud vers sa broche de sortie).
Spécifications
En-tête |
Ksmedia.h (inclure Ksmedia.h) |