KSPROPERTY_AUDIO_ALGORITHM_INSTANCE

Articolo
06/15/2023

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à
Sì	Sì	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.