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