KSPROPERTY_AUDIO_ALGORITHM_INSTANCE

La proprietà KSPROPERTY_AUDIO_ALGORITHM_INSTANCE specifica l'algoritmo DSP (Digital Signal Processing) usato per ottenere l'effetto di terze parti applicato al flusso di dati audio. Gli effetti definiti per questa proprietà includono l'annullamento dell'eco acustico e l'eliminazione del rumore.

Tabella riepilogo utilizzo

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

Filtra

KSNODEPROPERTY

GUID

Il valore della proprietà (dati operazione) è un GUID che identifica l'effetto che il pin si applica al flusso di dati. Questo valore può essere uno dei GUID seguenti dal file di intestazione Ksmedia.h:

KSALGORITHMINSTANCE_SYSTEM_AGC
Riservate per utilizzo futuro

KSALGORITHMINSTANCE_SYSTEM_ACOUSTIC_ECHO_CANCEL
Algoritmo di annullamento dell'eco acustico predefinito del sistema

KSALGORITHMINSTANCE_SYSTEM_MICROPHONE_ARRAY_PROCESSOR
Riservate per utilizzo futuro

KSALGORITHMINSTANCE_SYSTEM_NOISE_SUPPRESS
Algoritmo di eliminazione del rumore predefinito del sistema

Valore restituito

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

Commenti

Questa proprietà viene usata per controllare l'algoritmo DSP eseguito da un nodo AEC (KSNODETYPE_ACOUSTIC_ECHO_CANCEL) o un nodo di eliminazione del rumore (KSNODETYPE_NOISE_SUPPRESS).

Il GUID dell'istanza dell'algoritmo corrisponde al valore nel membro guidDSCFXInstance di una struttura DSCEFFECTDESC che un chiamante passa al metodo IDirectSoundCapture::CreateCaptureBuffer o DirectSoundFullDuplexCreate . Per altre informazioni, vedere la documentazione di Microsoft Windows SDK.

Requisiti

Intestazione

Ksmedia.h (includere Ksmedia.h)

Vedere anche

KSNODEPROPERTY

KSNODETYPE_ACOUSTIC_ECHO_CANCEL

KSNODETYPE_NOISE_SUPPRESS