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

Структура KSAUDIO_PREFERRED_STATUS указывает состояние предпочтительного устройства.

Синтаксис

typedef struct {
  BOOL                             Enable;
  KSPROPERTY_SYSAUDIO_DEFAULT_TYPE DeviceType;
  ULONG                            Flags;
  ULONG                            Reserved;
} KSAUDIO_PREFERRED_STATUS, *PKSAUDIO_PREFERRED_STATUS;

Члены

Enable

Указывает, является ли целевое устройство новым предпочтительным устройством. Если задано значение TRUE, в качестве нового предпочтительного устройства выбирается целевое устройство. Если значение FALSE, целевое устройство ранее было предпочтительным устройством, но теперь не выбрано.

DeviceType

Указывает тип предпочтительного устройства. Для этого параметра задана одна из следующих констант:

Значение	Тип устройства
KSPROPERTY_SYSAUDIO_NORMAL_DEFAULT	Предпочтительное устройство для воспроизведения и записи волн, MIDI и топологии микшера.
KSPROPERTY_SYSAUDIO_PLAYBACK_DEFAULT	Предпочтительное устройство воспроизведения волн.
KSPROPERTY_SYSAUDIO_RECORD_DEFAULT	Предпочтительное устройство записи волн.
KSPROPERTY_SYSAUDIO_MIDI_DEFAULT	Предпочитаемое устройство MIDI.
KSPROPERTY_SYSAUDIO_MIXER_DEFAULT	Предпочтительное устройство топологии микшера.

Драйвер использует этот элемент, чтобы определить, какие аспекты звукового адаптера в настоящее время выбраны в качестве предпочтительных. Драйвер может использовать эти сведения, чтобы решить, как настроить себя или какие системные ресурсы запрашивать.

Flags

В настоящее время флаги не определены. Задайте нулевое значение.

Reserved

Зарезервировано для последующего использования. Задайте нулевое значение.

Комментарии

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

Сведения о предпочтительном устройстве см. в разделе SetupPreferredAudioDevices.

Требования

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

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

KSPROPERTY_AUDIO_PREFERRED_STATUS

SetupPreferredAudioDevices