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) |