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

KSPROPERTY_AUDIO_AGC

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)

See also

KSNODETYPE_DEV_SPECIFIC

KSPROPERTY_AUDIO_AGC