Compartir a través de


KSPROPERTY_AUDIO_ALGORITHM_INSTANCE

La propiedad KSPROPERTY_AUDIO_ALGORITHM_INSTANCE especifica el algoritmo de procesamiento de señales digitales (DSP) que se usa para lograr el efecto de terceros que el nodo aplica a la secuencia de datos de audio. Los efectos definidos para esta propiedad incluyen la cancelación acústica del eco y la supresión de ruido.

Tabla de resumen de uso

Obtener Set Destino Tipo de descriptor de propiedad Tipo de valor de propiedad

Filtrar

KSNODEPROPERTY

GUID

El valor de propiedad (datos de operación) es un GUID que identifica el efecto que el pin aplica a su flujo de datos. Este valor puede ser uno de los siguientes GUID del archivo de encabezado Ksmedia.h:

KSALGORITHMINSTANCE_SYSTEM_AGC
Reservado para uso futuro

KSALGORITHMINSTANCE_SYSTEM_ACOUSTIC_ECHO_CANCEL
Algoritmo de cancelación de eco acústico predeterminado del sistema

KSALGORITHMINSTANCE_SYSTEM_MICROPHONE_ARRAY_PROCESSOR
Reservado para uso futuro

KSALGORITHMINSTANCE_SYSTEM_NOISE_SUPPRESS
Algoritmo de supresión de ruido predeterminado del sistema

Valor devuelto

Una solicitud de propiedad KSPROPERTY_AUDIO_ALGORITHM_INSTANCE devuelve STATUS_SUCCESS para indicar que se ha completado correctamente. De lo contrario, la solicitud devuelve un código de estado de error adecuado.

Observaciones

Esta propiedad se usa para controlar el algoritmo DSP que realiza un nodo AEC (KSNODETYPE_ACOUSTIC_ECHO_CANCEL) o un nodo de supresión de ruido (KSNODETYPE_NOISE_SUPPRESS).

El GUID de instancia de algoritmo coincide con el valor del miembro guidDSCFXInstance de una estructura DSCEFFECTDESC que un llamador pasa al método IDirectSoundCapture::CreateCaptureBuffer o a la función DirectSoundFullDuplexCreate . Para obtener más información, consulte la documentación de Microsoft Windows SDK.

Requisitos

Encabezado

Ksmedia.h (incluye Ksmedia.h)

Vea también

KSNODEPROPERTY

KSNODETYPE_ACOUSTIC_ECHO_CANCEL

KSNODETYPE_NOISE_SUPPRESS