KSPROPERTY_AUDIO_ALGORITHM_INSTANCE

Article
06/15/2023

La propriété KSPROPERTY_AUDIO_ALGORITHM_INSTANCE spécifie l’algorithme de traitement du signal numérique (DSP) utilisé pour obtenir l’effet tiers que le nœud applique au flux de données audio. Les effets définis pour cette propriété incluent l’annulation de l’écho acoustique et la suppression du bruit.

Tableau récapitulatif de l’utilisation

Obtenir	Définissez	Cible	Type de descripteur de propriété	Type de valeur de propriété
Oui	Oui	Filtrer	KSNODEPROPERTY	GUID

La valeur de propriété (données d’opération) est un GUID qui identifie l’effet que la broche s’applique à son flux de données. Cette valeur peut être l’un des GUID suivants du fichier d’en-tête Ksmedia.h :

KSALGORITHMINSTANCE_SYSTEM_AGC
Paramètres réservés pour un usage ultérieur

KSALGORITHMINSTANCE_SYSTEM_ACOUSTIC_ECHO_CANCEL
Algorithme d’annulation d’écho acoustique par défaut du système

KSALGORITHMINSTANCE_SYSTEM_MICROPHONE_ARRAY_PROCESSOR
Paramètres réservés pour un usage ultérieur

KSALGORITHMINSTANCE_SYSTEM_NOISE_SUPPRESS
Algorithme de suppression du bruit par défaut du système

Valeur de retour

Une demande de propriété KSPROPERTY_AUDIO_ALGORITHM_INSTANCE retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la demande retourne une erreur appropriée status code.

Notes

Cette propriété est utilisée pour contrôler l’algorithme DSP qui est effectué par un nœud AEC (KSNODETYPE_ACOUSTIC_ECHO_CANCEL) ou un nœud de suppression du bruit (KSNODETYPE_NOISE_SUPPRESS).

Le GUID instance l’algorithme correspond à la valeur dans le membre guidDSCFXInstance d’une structure DSCEFFECTDESC qu’un appelant transmet à la méthode IDirectSoundCapture::CreateCaptureBuffer ou à la fonction DirectSoundFullDuplexCreate. Pour plus d’informations, consultez la documentation Microsoft Windows SDK.