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

要求

要求
Header ksmedia.h (包括 Ksmedia.h)

另请参阅

KSPROPERTY_AUDIO_PREFERRED_STATUS

SetupPreferredAudioDevices