KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST
Свойство KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST — это свойство фильтра, значение которого представляет собой список типов звуковых эффектов, применяемых к определенной фабрике контактов KS для определенного пути обработки звукового сигнала.
Сводная таблица использования
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Да |
Нет |
Фабрика контактов (с помощью экземпляра фильтра) |
KSP_PIN |
KSP_PINMODE |
Значение свойства представляет собой массив GUID типа звуковых эффектов (например, AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION), которые находятся в пути обработки сигналов контакта, определяемом структурой KSP_PINMODE .
Примечание Бит флага KSPROPERTY_TYPE_TOPOLOGY не должен быть задан для этого свойства.
Возвращаемое значение
Запрос свойства KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае этот запрос свойства возвращает соответствующий код состояния ошибки.
Комментарии
Если аудиодрайвер использует универсальный прокси-объект microsoft для получения звуковых эффектов, включенных в различные пути обработки сигналов для контакта KS, он должен поддерживать это свойство. Универсальный прокси-объект APO содержится в файлеmsapofxproxy.dll . Аудиодрайверы могут использовать этот универсальный прокси-сервер APO, если вся обработка сигнала выполняется в звуковом драйвере или в соответствующем аппаратном компоненте DSP без обработки в APO. В этом случае единственная функция APO — сообщать о эффектах обработки сигналов в аудиосистему.
Универсальный прокси-сервер APO получает KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST от звукового драйвера и использует его для передачи результатов в аудиосистему. Универсальный прокси-объект APO предполагает, что список эффектов не меняется, пока включен интерфейс фильтра контакта KS.
Если дескриптор свойства задает контакт KS, который не поддерживает KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST, драйвер должен вернуть STATUS_NOT_SUPPORTED.
Если дескриптор свойства задает значение AudioProcessingMode , которое драйвер не поддерживает, драйвер должен вернуть STATUS_INVALID_PARAMETER. Обратите внимание, что звуковой драйвер должен поддерживать свойство KSPROPERTY_AUDIOSIGNALPROCESSING_MODES , чтобы иметь возможность указывать поддерживаемые режимы обработки звуковых сигналов.
Требования
Версия |
Windows 8.1 |
Заголовок |
Msapofxproxy.h |