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à |
---|---|---|---|---|
Sì |
Sì |
Filtra |
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) |