KSPROPERTY_TOPOLOGYNODE_ENABLE
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 |
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).
Anforderungen
Header |
Ksmedia.h (einschließlich Ksmedia.h) |