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.
| Get | Set | Target | Property descriptor type | Property 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_Acoustic_Echo_Cancel
KSPROPSETID_DirectSound3DBuffer