KSAUDIO_PREFERRED_STATUS - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ksmedia.h
typedef struct {
BOOL Enable;
KSPROPERTY_SYSAUDIO_DEFAULT_TYPE DeviceType;
ULONG Flags;
ULONG Reserved;
} KSAUDIO_PREFERRED_STATUS, *PKSAUDIO_PREFERRED_STATUS;
View the official Windows Driver Kit DDI referenceNo description available.
The KSAUDIO_PREFERRED_STATUS structure specifies the status of a preferred device.
EnableSpecifies whether the target device is the new preferred device. If TRUE, the target device is selected as the new preferred device. If FALSE, the target device was previously the preferred device, but is now deselected.
DeviceTypeSpecifies the type of preferred device. This parameter is set to one of the following constants:
| Value | Device type |
|---|---|
| KSPROPERTY_SYSAUDIO_NORMAL_DEFAULT | Preferred device for wave playback/recording, MIDI, and mixer topology. |
| KSPROPERTY_SYSAUDIO_PLAYBACK_DEFAULT | Preferred wave playback device. |
| KSPROPERTY_SYSAUDIO_RECORD_DEFAULT | Preferred wave recording device. |
| KSPROPERTY_SYSAUDIO_MIDI_DEFAULT | Preferred MIDI device. |
| KSPROPERTY_SYSAUDIO_MIXER_DEFAULT | Preferred mixer topology device. |
The driver uses this member to determine what aspect or aspects of the audio adapter are currently selected as preferred. A driver might use this information to decide how to configure itself or decide what system resources to request.
FlagsNo flags are currently defined. Set to zero.
ReservedReserved for future use. Set to zero.
This structure is used by the KSPROPERTY_AUDIO_PREFERRED_STATUS property.
For information about the preferred device, see SetupPreferredAudioDevices.
KSPROPERTY_AUDIO_PREFERRED_STATUS