Наборы свойств аудиодрайверов
В этом разделе описываются наборы свойств для звука, доступные для аудиодрайверов, использующих службы потоковой передачи ядра WDM в Microsoft Windows 2000 и более поздних версиях, а также в Windows Millennium Edition (Me) и Windows 98.
Страница ссылок для каждого свойства содержит таблицу со следующими заголовками столбцов.
| Get | Set | целевого объекта | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Эти заголовки имеют следующие значения:
Get
Поддерживает ли целевой объект KS запрос свойства KSPROPERTY_TYPE_GET? (Укажите да или нет.)
Set
Поддерживает ли целевой объект KS запрос свойства KSPROPERTY_TYPE_SET? (Укажите да или нет.)
Целевой объект
Целевым объектом для запроса является объект KS, в который отправляется запрос на свойство. Целевым объектом для свойства audio является фильтр или закрепление. (Запрос свойства указывает целевой объект с помощью дескриптора ядра.)
Тип дескриптора свойства
Дескриптор свойства указывает свойство и операцию, выполняемую с этим свойством. Дескриптор всегда начинается со структуры KSPROPERTY , но некоторые типы дескриптора содержат дополнительные сведения. Например, структура KSNODEPROPERTY — это дескриптор свойства, который начинается со структуры KSPROPERTY, но также включает идентификатор узла.
Тип значения свойства
Свойство обычно имеет значение, и тип этого значения зависит от свойства . Например, свойство, которое может находиться только в одном из двух состояний ( on или off), обычно имеет значение BOOL. Свойство, которое может принимать целочисленные значения от 0 до 0xFFFFFFFF, может иметь значение ULONG. Более сложные свойства могут иметь значения, которые являются массивами или структурами.
Предыдущий дескриптор и значение свойства являются версиями буферов спецификации экземпляров и операций, которые рассматриваются в разделе Свойства, события и методы KS.
В запросе свойства используется один из следующих флагов для указания операции, которая должна быть выполнена со свойством :
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Все объекты фильтра и закрепления поддерживают операцию базовой поддержки для своих свойств. Поддержка операций получения и задания зависит от свойства . Свойство, представляющее неотъемлемую возможность объекта фильтра или закрепления, скорее всего, потребует только операции получения. Для свойства, представляющего настраиваемый параметр, может потребоваться только операция задания, хотя операция получения также может быть полезна для чтения текущего параметра. Дополнительные сведения об использовании операций получения, задания и базовой поддержки со свойствами звука см. в разделе Конечные точки аудио, свойства и события.
Для аудиодрайверов определяются следующие наборы свойств:
KSPROPSETID_Acoustic_Echo_Cancel
KSPROPSETID_DirectSound3DBuffer