KSPROPERTY_AUDIO_ALGORITHM_INSTANCE
Свойство KSPROPERTY_AUDIO_ALGORITHM_INSTANCE указывает алгоритм цифровой обработки сигналов (DSP), используемый для достижения стороннего эффекта, применяемого узлом к потоку звуковых данных. К эффектам, определенным для этого свойства, относятся акустическая эхоподавление и подавление шума.
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Да |
Да |
Фильтр |
GUID |
Значение свойства (данные операции) — это GUID, который определяет эффект, который контакт применяет к потоку данных. Это значение может быть одним из следующих идентификаторов GUID из файла заголовка Ksmedia.h:
KSALGORITHMINSTANCE_SYSTEM_AGC
Зарезервировано для использования в будущем.
KSALGORITHMINSTANCE_SYSTEM_ACOUSTIC_ECHO_CANCEL
Системный алгоритм акустического эхо-подавления по умолчанию
KSALGORITHMINSTANCE_SYSTEM_MICROPHONE_ARRAY_PROCESSOR
Зарезервировано для использования в будущем.
KSALGORITHMINSTANCE_SYSTEM_NOISE_SUPPRESS
Системный алгоритм подавления шума по умолчанию
Возвращаемое значение
Запрос свойства KSPROPERTY_AUDIO_ALGORITHM_INSTANCE возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния ошибки.
Комментарии
Это свойство используется для управления алгоритмом DSP, выполняемым узлом AEC (KSNODETYPE_ACOUSTIC_ECHO_CANCEL) или узлом подавления шума (KSNODETYPE_NOISE_SUPPRESS).
Идентификатор GUID экземпляра алгоритма соответствует значению в элементе guidDSCFXInstance структуры DSCEFFECTDESC, которую вызывающий объект передает в метод IDirectSoundCapture::CreateCaptureBuffer или функцию DirectSoundFullDuplexCreate . Дополнительные сведения см. в документации по Microsoft Windows SDK.
Требования
Заголовок |
Ksmedia.h (включая Ksmedia.h) |