KSPROPERTY_AUDIO_PREFERRED_STATUS

The KSPROPERTY_AUDIO_PREFERRED_STATUS property informs a device that it is the system's preferred audio device.

Usage Summary Table

Get Set Target Property descriptor type Property value type

No

Yes

Filter

KSPROPERTY

KSAUDIO_PREFERRED_STATUS

The property value (operation data) is a structure of type KSAUDIO_PREFERRED_STATUS that specifies the type of preferred device and whether the device is selected or deselected as the preferred device for that device type.

Return Value

A KSPROPERTY_AUDIO_PREFERRED_STATUS property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.

Remarks

The SysAudio system driver uses this property to inform a wave playback, wave record, MIDI, or mixer device when it is selected to be the new preferred device, or when a previously selected preferred device is deselected.

For information about preferred devices, see SetupPreferredAudioDevices.

Requirements

Header

Ksmedia.h (include Ksmedia.h)

See also

KSPROPERTY

KSAUDIO_PREFERRED_STATUS

SetupPreferredAudioDevices