KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST

A propriedade KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST é uma propriedade de filtro cujo valor é uma lista de tipos de efeito de áudio que são aplicados a uma fábrica de pinos KS específica, para um caminho de processamento de sinal de áudio específico.

Tabela de Resumo de Uso

Tabela de Resumo de Uso

Obter	Definir	Destino	Tipo de descritor de propriedade	Tipo de valor da propriedade
Sim	Não	Fábrica de pinos (por meio da instância de filtro)	KSP_PIN	KSP_PINMODE

O valor da propriedade é uma matriz de zero ou mais GUIDs de tipo de efeito de áudio (por exemplo, AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION) que estão no caminho de processamento de sinal do pino identificado pela estrutura de KSP_PINMODE .

Nota O bit de sinalizador KSPROPERTY_TYPE_TOPOLOGY não deve ser definido para essa propriedade.

Valor Retornado

A solicitação de propriedade KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST retorna STATUS_SUCCESS para indicar que foi concluída com êxito. Caso contrário, essa solicitação de propriedade retornará um erro apropriado status código.

Comentários

Se um driver de áudio usar o APO de proxy genérico da Microsoft para recuperar os efeitos de áudio incluídos nos diferentes caminhos de processamento de sinal para um pino KS, ele deverá dar suporte a essa propriedade. O APO de proxy genérico está contido no arquivo msapofxproxy.dll . Os drivers de áudio podem usar esse APO de proxy genérico quando todo o processamento de sinal é feito no driver de áudio ou no componente de hardware do DSP (processador de sinal digital) correspondente, sem nenhum processamento sendo feito em um APO. Nesse caso, a única função do APO é relatar os efeitos de processamento de sinal para o sistema de áudio.

O APO de proxy genérico recebe KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST do driver de áudio e o usa para relatar os efeitos para o sistema de áudio. O APO de proxy genérico pressupõe que a lista de efeitos não seja alterada enquanto a interface de filtro do pino KS estiver habilitada.

Se o descritor de propriedade especificar um pino KS que não dá suporte a KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST, o driver deverá retornar STATUS_NOT_SUPPORTED.

Se o descritor de propriedade especificar um valor AudioProcessingMode que o driver não dá suporte, o driver deverá retornar STATUS_INVALID_PARAMETER. Observe que um driver de áudio deve dar suporte à propriedade KSPROPERTY_AUDIOSIGNALPROCESSING_MODES para poder indicar seus modos de processamento de sinal de áudio com suporte.

Requisitos

Versão	Windows 8.1
Cabeçalho	Msapofxproxy.h

Confira também

KSP_PINMODE

KSPROPERTY_AUDIOSIGNALPROCESSING_MODES