структура 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 (include Ksmedia.h) |