KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST

La propriété KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST est une propriété de filtre dont la valeur est une liste de types d’effets audio appliqués à une fabrique de brocheS KS particulière, pour un chemin de traitement de signal audio particulier.

Tableau récapitulatif de l’utilisation

Tableau récapitulatif de l’utilisation

Obtenir	Définissez	Cible	Type de descripteur de propriété	Type de valeur de propriété
Oui	Non	Fabrique d’épingles (via filter instance)	KSP_PIN	KSP_PINMODE

La valeur de la propriété est un tableau de zéro ou plusieurs GUID de type effet audio (par exemple, AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION) qui se trouvent dans le chemin de traitement du signal de l’épingle identifié par la structure KSP_PINMODE .

Note Le bit d’indicateur KSPROPERTY_TYPE_TOPOLOGY ne doit pas être défini pour cette propriété.

Valeur renvoyée

La demande de propriété KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, cette demande de propriété renvoie une erreur appropriée status code.

Notes

Si un pilote audio utilise le proxy générique APO de Microsoft pour récupérer les effets audio inclus dans les différents chemins de traitement du signal pour une broche KS, il doit prendre en charge cette propriété. Le proxy générique APO est contenu dans le fichier msapofxproxy.dll . Les pilotes audio peuvent utiliser ce proxy apo générique lorsque tout le traitement du signal est effectué dans le pilote audio ou dans le composant matériel du processeur de signal numérique (DSP) correspondant, sans qu’aucun traitement ne soit effectué dans une APO. Dans ce cas, la seule fonction de l’APO consiste à signaler les effets de traitement du signal au système audio.

Le proxy générique APO reçoit KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST du pilote audio et l’utilise pour signaler les effets au système audio. L’APO du proxy générique suppose que la liste des effets ne change pas lorsque l’interface de filtre de la broche KS est activée.

Si le descripteur de propriété spécifie une broche KS qui ne prend pas en charge KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST, le pilote doit retourner STATUS_NOT_SUPPORTED.

Si le descripteur de propriété spécifie une valeur AudioProcessingMode que le pilote ne prend pas en charge, le pilote doit retourner STATUS_INVALID_PARAMETER. Notez qu’un pilote audio doit prendre en charge la propriété KSPROPERTY_AUDIOSIGNALPROCESSING_MODES pour pouvoir indiquer les modes de traitement du signal audio pris en charge.

Spécifications

Version	Windows 8.1
En-tête	Msapofxproxy.h

Voir aussi

KSP_PINMODE

KSPROPERTY_AUDIOSIGNALPROCESSING_MODES