KSPROPERTY_SYSAUDIO_DEVICE_COUNT
Свойство KSPROPERTY_SYSAUDIO_DEVICE_COUNT извлекает число, указывающее количество виртуальных звуковых устройств, которые должна выбрать программа приложения DirectSound.
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Да |
Нет |
Фильтр |
ULONG |
Значение свойства (данные операции) — это переменная ULONG, в которую SysAudio записывает число, указывающее количество виртуальных звуковых устройств для выбора. Если SysAudio перечисляет n виртуальных звуковых устройств, эти устройства идентифицируются по идентификаторам устройств от 0 до n-1.
Возвращаемое значение
Запрос свойства KSPROPERTY_SYSAUDIO_DEVICE_COUNT возвращает STATUS_SUCCESS, указывающий на успешное завершение. В противном случае запрос возвращает соответствующий код состояния ошибки.
Комментарии
SysAudio перечисляет уникальное виртуальное звуковое устройство для каждого включенного аппаратного устройства в системе, выполняющего отрисовку волн. В каждом экземпляре виртуальное звуковое устройство состоит из аппаратного устройства, системного драйвера KMixer и других звуковых компонентов. Приложение DirectSound выбирает определенное аппаратное устройство, выбирая виртуальное звуковое устройство, включающее аппаратное устройство.
Например, если три аудиоадаптера подключены к системной шине и каждая из них содержит устройство отрисовки волн с драйвером miniport WaveCyclic или WavePci, SysAudio перечисляет три виртуальных звуковых устройства с идентификаторами устройств 0, 1 и 2.
SysAudio ведет список виртуальных звуковых устройств в системном реестре в категории KSCATEGORY_AUDIO_DEVICE. Эта категория зарезервирована исключительно для использования SysAudio. DirectSound не обращается напрямую к сведениям о виртуальных звуковых устройствах из системного реестра. Вместо этого он запрашивает у SysAudio свойства виртуальных звуковых устройств.
Требования
Заголовок |
Ksmedia.h (включая Ksmedia.h) |