KSPROPERTY_TOPOLOGYNODE_ENABLE

La proprietà KSPROPERTY_TOPOLOGYNODE_ENABLE viene usata per attivare o disattivare i nodi della topologia in una topologia già compilata.

Tabella riepilogo utilizzo

Recupero Set Destinazione Tipo di descrittore di proprietà Tipo valore proprietà

Filtra

KSNODEPROPERTY

BOOL

Il valore della proprietà (dati dell'operazione) è di tipo BOOL e specifica se il nodo è attivato o disattivato. Il valore TRUE indica che il nodo è attivato. FALSE indica che il nodo è disattivato.

Valore restituito

Una richiesta di proprietà KSPROPERTY_TOPOLOGYNODE_ENABLE restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.

Commenti

L'abilitazione di un nodo già abilitato o la disabilitazione di un nodo già disabilitato non ha alcun effetto, ma non deve essere considerata come un errore.

La disabilitazione di un nodo disattiva la trasformazione eseguita dal nodo nel flusso che passa attraverso il nodo. Nel caso di un nodo AEC, AGC o di eliminazione del rumore (KSNODETYPE_ACOUSTIC_ECHO_CANCEL, KSNODETYPE_AGC o KSNODETYPE_NOISE_SUPPRESS), ad esempio, un nodo disabilitato opera in modalità pass-through,ovvero non esegue alcuna operazione sul flusso mentre passa dal pin di input del nodo al pin di output.

Requisiti

Intestazione

Ksmedia.h (include Ksmedia.h)

Vedere anche

KSNODEPROPERTY

KSNODETYPE_ACOUSTIC_ECHO_CANCEL

KSNODETYPE_AGC

KSNODETYPE_NOISE_SUPPRESS