KSPROPERTY_AUDIO_DEV_SPECIFIC
The KSPROPERTY_AUDIO_DEV_SPECIFIC property is used to access a device-specific property in a device-specific node (KSNODETYPE_DEV_SPECIFIC).
Usage Summary Table
| Get | Set | Target | Property descriptor type | Property value type |
|---|---|---|---|---|
<device-specific> |
<device-specific> |
<device-specific> |
<device-specific> |
<device-specific> |
The property value (operation data) is expressed in a device-specific format.
Whether the property supports get- or set-property requests is also device-specific.
Return Value
This property returns either STATUS_SUCCESS or a device specific value determined by the third-party provider of the audio driver.
Remarks
In Windows Vista and later versions of Windows, an additional tab (labeled Custom) is provided in the Sound applet in Control Panel. The Custom tab displays controls for automatic gain control (AGC) and device-specific properties. The following table shows the controls that are exposed in the Sound applet for the various KSPROPERTY_AUDIO_DEV_SPECIFIC property and data type combinations.
| KSPROPERTY | Data type | Control |
|---|---|---|
BOOL |
Check box |
|
KSPROPERTY_AUDIO_DEV_SPECIFIC |
BOOL |
Check box |
KSPROPERTY_AUDIO_DEV_SPECIFIC |
LONG |
Slider |
KSPROPERTY_AUDIO_DEV_SPECIFIC |
ULONG |
Slider |
KSPROPERTY_AUDIO_AGC must be used to expose actual AGC functionality in the device. Other device-specific functionality must be exposed by using KSPROPERTY_AUDIO_DEV_SPECIFIC.
To see the Custom tab, select an audio render or capture device in the Sound applet and then click Properties.
For an example of how to implement a property handler for the KSPROPERTY_AUDIO_DEV_SPECIFIC property, see the CMiniportTopologyMSVAD::PropertyHandlerDevSpecific method in the Basetopo.cpp file.
Requirements
Version |
Available in Windows Vista and later versions of the Windows operating systems. |
Header |
Ksmedia.h (include Ksmedia.h) |