структура SYSAUDIO_INSTANCE_INFO (ksmedia.h)

  • Статья

Структура SYSAUDIO_INSTANCE_INFO указывает, какое виртуальное звуковое устройство нужно открыть, и включает флаги для настройки этого устройства.

Синтаксис

typedef struct {
  KSPROPERTY Property;
  ULONG      Flags;
  ULONG      DeviceNumber;
} SYSAUDIO_INSTANCE_INFO, *PSYSAUDIO_INSTANCE_INFO;

Члены

Property

Задает свойство . Этот параметр является структурой типа KSPROPERTY.

Flags

Флаги, указывающие, как настроить виртуальное звуковое устройство. В настоящее время единственным битом флага, определенным для этого параметра, является SYSAUDIO_FLAGS_DONT_COMBINE_PINS. Если этот бит флага задан, sysAudio не следует комбинировать маркеры отрисовки. Дополнительные сведения см. в разделе "Примечания".

DeviceNumber

Указывает идентификатор устройства. Этот член идентифицирует виртуальное звуковое устройство, которое должно быть открыто запросом свойства. Если SysAudio перечисляет N виртуальных звуковых устройств (см . KSPROPERTY_SYSAUDIO_DEVICE_COUNT), допустимые идентификаторы устройств варьируются от 0 до N-1.

Комментарии

Эта структура используется свойством KSPROPERTY_SYSAUDIO_INSTANCE_INFO .

По умолчанию виртуальное звуковое устройство объединяет свои контакты для отрисовки волн. Флаг SYSAUDIO_FLAGS_DONT_COMBINE_PINS переопределяет это значение по умолчанию.

При объединении контактов виртуальное звуковое устройство предоставляет единую фабрику контактов, которая объединяет контакты отрисовки с аппаратным ускорением на звуковом устройстве с программной эмулируемой контактами микшера в драйвере системы KMixer. Если контакты не объединяются, то контакты с аппаратным ускорением и программные эмулированные контакты предоставляются через отдельные фабрики контактов. Чтобы правильно сообщать о количестве контактов с аппаратным ускорением в приложениях, DirectSound требует, чтобы контакты не были объединены.

Это свойство похоже на KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE, за исключением того, что оно включает флаги, указывающие, как настроить виртуальное звуковое устройство.

Требования

Требование Значение
Заголовок ksmedia.h (включая Ksmedia.h)

См. также раздел

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO