Partager via


KSPROPERTY_AUDIO_ALGORITHM_INSTANCE

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.

Spécifications

En-tête

Ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSNODEPROPERTY

KSNODETYPE_ACOUSTIC_ECHO_CANCEL

KSNODETYPE_NOISE_SUPPRESS