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 |