Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

KSAUDIO_PREFERRED_STATUS structure

The KSAUDIO_PREFERRED_STATUS structure specifies the status of a preferred device.

Syntax


typedef struct {
  BOOL                             Enable;
  KSPROPERTY_SYSAUDIO_DEFAULT_TYPE DeviceType;
  ULONG                            Flags;
  ULONG                            Reserved;
} KSAUDIO_PREFERRED_STATUS, *PKSAUDIO_PREFERRED_STATUS;

Members

Enable

Specifies 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.

DeviceType

Specifies the type of preferred device. This parameter is set to one of the following constants:

ValueDevice 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.

Flags

No flags are currently defined. Set to zero.

Reserved

Reserved for future use. Set to zero.

Remarks

This structure is used by the KSPROPERTY_AUDIO_PREFERRED_STATUS property.

For information about the preferred device, see SetupPreferredAudioDevices.

Requirements

Header

Ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY_AUDIO_PREFERRED_STATUS
SetupPreferredAudioDevices

 

 

Send comments about this topic to Microsoft

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.