KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE
Свойство KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE создает новый виртуальный источник.
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Да |
Нет |
Фильтр |
ULONG |
Дескриптор свойства (данные экземпляра) — это структура типа SYSAUDIO_CREATE_VIRTUAL_SOURCE, которая задает идентификаторы GUID категории контактов и пин-имени для виртуального источника.
Значение свойства (данные операции) — это переменная ULONG, содержащая индекс виртуального источника. SysAudio создает этот индекс для идентификации нового виртуального источника.
Возвращаемое значение
Запрос свойства KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE возвращает STATUS_SUCCESS, указывающий на успешное завершение. В противном случае запрос возвращает соответствующий код состояния ошибки.
Комментарии
Это свойство используется для создания виртуального источника линии микшера, например тома или элемента управления выключением звука.
Если SysAudio уже создал виртуальный источник с теми же идентификаторами GUID pin-category и pin-name, KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE запрос get-property извлекает индекс существующего виртуального источника. В противном случае запрос создает новый индекс виртуального источника и выводит это значение.
После того как SysAudio назначит индекс виртуальному источнику, можно использовать запрос KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCEset-property для подключения этого виртуального источника к экземпляру закрепления на виртуальном звуковом устройстве.
Пользователь управляет уровнями громкости различных источников звука с помощью приложения SndVol32. К этим источникам относятся устройство вывода волн, синтезатор MIDI, CD-проигрыватель и встроенный разъем. SndVol32 использует функции Windows multimedia waveOutXxx, midiOutXxx и auxXxx для управления уровнями громкости для этих источников. Дополнительные сведения о мультимедийных функциях Windows см. в документации по Microsoft Windows SDK.
SysAudio перехватывает изменения тома, внесенные на этих устройствах, и применяет их к своим виртуальным источникам. Например, если программный синтезатор MIDI, который преобразует MIDI-файл в волновые данные, подключен к одному из контактов отрисовки волн виртуального звукового устройства, SysAudio применяет изменения тома midiOutXxx к контакту (вместо изменения тома waveOutXxx ). Аналогичным образом, если драйвер системы Redbook, который преобразует цифровой звук из CD-проигрывателя в волновые данные, подключен к одному из контактов отрисовки волн виртуального звукового устройства, SysAudio применяется AUXCAPS_CDAUDIO изменения громкости к контакту. Дополнительные сведения о структуре AUXCAPS_CDAUDIO см. в документации windows SDK.
Требования
Заголовок |
Ksmedia.h (включая Ksmedia.h) |