KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST
La propiedad KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST es una propiedad de filtro cuyo valor es una lista de tipos de efectos de audio que se aplican a un generador de patillas KS determinado, para una ruta de procesamiento de señal de audio determinada.
Tabla de resumen de uso
Tabla de resumen de uso
| Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
|---|---|---|---|---|
Sí |
No |
Generador de patillas (a través de la instancia de filtro) |
KSP_PIN |
KSP_PINMODE |
El valor de la propiedad es una matriz de cero o más GUID de tipo de efecto de audio (por ejemplo, AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION) que se encuentran en la ruta de acceso de procesamiento de señal del pin identificada por la estructura KSP_PINMODE .
Nota El bit de marca KSPROPERTY_TYPE_TOPOLOGY no debe establecerse para esta propiedad.
Valor devuelto
La solicitud de propiedad KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, esta solicitud de propiedad devuelve un código de estado de error adecuado.
Observaciones
Si un controlador de audio usa el APO de proxy genérico de Microsoft para recuperar los efectos de audio que se incluyen en las diferentes rutas de procesamiento de señal para un pin KS, debe admitir esta propiedad. El APO de proxy genérico se encuentra en el archivo msapofxproxy.dll . Los controladores de audio pueden usar este APO de proxy genérico cuando se realiza todo el procesamiento de señal en el controlador de audio o en el componente de hardware del procesador de señal digital (DSP) correspondiente, sin que se realice ningún procesamiento en un APO. En este caso, la única función de APO es notificar los efectos de procesamiento de señal al sistema de audio.
El APO proxy genérico recibe KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST del controlador de audio y lo usa para notificar los efectos al sistema de audio. El APO de proxy genérico supone que la lista de efectos no cambia mientras la interfaz de filtro del pin KS está habilitada.
Si el descriptor de propiedad especifica un pin KS que no admite KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST, el controlador debe devolver STATUS_NOT_SUPPORTED.
Si el descriptor de propiedad especifica un valor AudioProcessingMode que el controlador no admite, el controlador debe devolver STATUS_INVALID_PARAMETER. Tenga en cuenta que un controlador de audio debe admitir la propiedad KSPROPERTY_AUDIOSIGNALPROCESSING_MODES para poder indicar sus modos de procesamiento de señal de audio admitidos.
Requisitos
Versión |
Windows 8.1 |
Encabezado |
Msapofxproxy.h |