Audio Drivers Property Sets

This section describes the audio-specific property sets that are available for audio drivers that use WDM kernel-streaming services in Microsoft Windows 2000 and later, and in Windows Millennium Edition (Me) and Windows 98.

The reference page for each property contains a table with the following column headings.

GetSetTargetProperty descriptor typeProperty value type

 

These headings have the following meanings:

  • Get

    Does the target KS object support the KSPROPERTY_TYPE_GET property request? (Specify yes or no.)

  • Set

    Does the target KS object support the KSPROPERTY_TYPE_SET property request? (Specify yes or no.)

  • Target

    The target for the request is the KS object that the property request is sent to. The target for an audio property is either a filter or a pin. (The property request specifies the target object by its kernel handle.)

  • Property Descriptor Type

    The property descriptor specifies the property and the operation to perform on that property. The descriptor always begins with a KSPROPERTY structure, but some types of descriptor contain additional information. For example, the KSNODEPROPERTY structure is a property descriptor that begins with a KSPROPERTY structure but also includes a node ID.

  • Property Value Type

    A property typically has a value, and the type of this value depends on the property. For example, a property that can be in one of only two states--on or off--typically has a BOOL value. A property that can assume integer values from 0 to 0xFFFFFFFF might have a ULONG value. More complex properties might have values that are arrays or structures.

The preceding property descriptor and property value are the property-specific versions of the instance-specification and operation-data buffers that are discussed in KS Properties, Events, and Methods.

A property request uses one of the following flags to specify the operation that is to be performed on the property:

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

All filter and pin objects support the basic-support operation on their properties. Whether they support the get and set operations depends on the property. A property that represents an inherent capability of the filter or pin object is likely to require only a get operation. A property that represents a configurable setting might require only a set operation, although a get operation might also be useful for reading the current setting. For more information about using the get, set, and basic-support operations with audio properties, see Audio Endpoints, Properties and Events.

The following property sets are defined for audio drivers:

KSPROPSETID_AC3

KSPROPSETID_Acoustic_Echo_Cancel

KSPROPSETID_Audio

KSPROPSETID_AudioEngine

KSPROPSETID_AudioGfx

KSPROPSETID_DirectSound3DBuffer

KSPROPSETID_DirectSound3DListener

KSPROPSETID_DrmAudioStream

KSPROPSETID_Hrtf3d

KSPROPSETID_Itd3d

KSPROPSETID_Jack

KSPROPSETID_RTAudio

KSPROPSETID_Synth

KSPROPSETID_SynthClock

KSPROPSETID_Synth_Dls

KSPROPSETID_Sysaudio

KSPROPSETID_Sysaudio_Pin

KSPROPSETID_TopologyNode

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft