KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST

La proprietà KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST è una proprietà filtro il cui valore è un elenco di tipi di effetti audio applicati a una determinata factory di pin KS, per un determinato percorso di elaborazione del segnale audio.

Tabella riepilogo utilizzo

Tabella riepilogo utilizzo

Recupero	Set	Destinazione	Tipo di descrittore delle proprietà	Tipo di valore della proprietà
Sì	No	Pin factory (tramite Istanza di filtro)	KSP_PIN	KSP_PINMODE

Il valore della proprietà è una matrice di GUID di tipo di effetto audio zero o più (ad esempio, AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION) che si trovano nel percorso di elaborazione del segnale del pin identificato dalla struttura KSP_PINMODE .

Nota Il bit KSPROPERTY_TYPE_TOPOLOGY flag non deve essere impostato per questa proprietà.

Valore restituito

La richiesta di proprietà KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, questa richiesta di proprietà restituisce un codice di stato di errore appropriato.

Commenti

Se un driver audio usa l'APO del proxy generico di Microsoft per recuperare gli effetti audio inclusi nei diversi percorsi di elaborazione dei segnali per un pin KS, deve supportare questa proprietà. L'APO del proxy generico è contenuto nel file msapofxproxy.dll . I driver audio possono usare questo apo proxy generico quando tutte le elaborazioni di segnali vengono eseguite nel driver audio o nel componente hardware DSP (Digital Signal Processor) corrispondente, senza eseguire alcuna elaborazione in un'APO. In questo caso, l'unica funzione dell'APO consiste nel segnalare gli effetti di elaborazione dei segnali al sistema audio.

L'APO proxy generico riceve KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST dal driver audio e lo usa per segnalare gli effetti al sistema audio. L'APO del proxy generico presuppone che l'elenco degli effetti non cambi mentre l'interfaccia filtro del pin KS è abilitata.

Se il descrittore della proprietà specifica un pin KS che non supporta KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST, il driver deve restituire STATUS_NOT_SUPPORTED.

Se il descrittore della proprietà specifica un valore AudioProcessingMode che il driver non supporta, il driver deve restituire STATUS_INVALID_PARAMETER. Si noti che un driver audio deve supportare la proprietà KSPROPERTY_AUDIOSIGNALPROCESSING_MODES per indicare le modalità di elaborazione del segnale audio supportate.

Requisiti

Versione	Windows 8.1
Intestazione	Msapofxproxy.h

Vedi anche

KSP_PINMODE

KSPROPERTY_AUDIOSIGNALPROCESSING_MODES