KSPROPERTY_TOPOLOGYNODE_ENABLE

Artikel
06/14/2023

Die eigenschaft KSPROPERTY_TOPOLOGYNODE_ENABLE wird verwendet, um die Topologieknoten in einer bereits erstellten Topologie zu aktivieren oder zu deaktivieren.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftendeskriptortyp	Eigenschaftswerttyp
Ja	Ja	Filter	KSNODEPROPERTY	BOOL

Der Eigenschaftswert (Vorgangsdaten) ist vom Typ BOOL und gibt an, ob der Knoten aktiviert oder deaktiviert ist. Der Wert TRUE gibt an, dass der Knoten aktiviert ist. FALSE gibt an, dass der Knoten deaktiviert ist.

Rückgabewert

Eine KSPROPERTY_TOPOLOGYNODE_ENABLE-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen geeigneten Fehler status Code zurück.

Bemerkungen

Das Aktivieren eines bereits aktivierten Knotens oder das Deaktivieren eines bereits deaktivierten Knotens hat keine Auswirkungen, sollte aber nicht als Fehler behandelt werden.

Durch Deaktivieren eines Knotens wird die Transformation deaktiviert, die der Knoten für den Stream ausführt, der den Knoten durchläuft. Im Fall eines AEC-, AGC- oder Rauschunterdrückungsknotens (KSNODETYPE_ACOUSTIC_ECHO_CANCEL, KSNODETYPE_AGC oder KSNODETYPE_NOISE_SUPPRESS) arbeitet ein deaktivierter Knoten beispielsweise im Passthrough-Modus (d. a. er führt keinen Vorgang für den Datenstrom aus, da er vom Eingabepin des Knotens zum Ausgabepin fließt).