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 |
---|---|---|---|---|
Sí |
Sí |
Filtrar |
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) |