структура 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) |