音频驱动程序属性集

本部分介绍可用于在 Microsoft Windows 2000 及更高版本中使用 WDM 内核流式处理服务的音频驱动程序,以及 Windows Millennium Edition (Me) 和 Windows 98 的音频特定属性集。

每个属性的引用页都包含具有以下列标题的表。

获取 设置 目标 属性描述符类型 属性值类型

这些标题将具有以下含义:

  • Get

    目标 KS 对象是否支持 KSPROPERTY_TYPE_GET 属性请求? (指定 yes 或 no。)

  • 设置

    目标 KS 对象是否支持 KSPROPERTY_TYPE_SET 属性请求? (指定 yes 或 no。)

  • Target

    请求的目标是将属性请求发送到的 KS 对象。 音频属性的目标是筛选器或引脚。 (属性请求通过其内核句柄指定目标对象。)

  • 属性描述符类型

    属性描述符指定属性以及要对该属性执行的操作。 描述符始终以 KSPROPERTY 结构开头,但某些类型的描述符包含其他信息。 例如,KSNODEPROPERTY 结构是一个属性描述符,以 KSPROPERTY 结构开头,但也包含节点 ID。

  • 属性值类型

    属性通常具有一个值,并且此值的类型取决于该属性。 例如,一个属性只能处于两个状态之一(on 或 off),通常具有 BOOL 值。 可以采用从 0 到 0xFFFFFFFF 范围内的整数值的属性可能具有 ULONG 值。 更复杂的属性可能具有数组或结构的值。

前面的属性描述符和属性值是 KS 属性、事件和方法中讨论的实例规范和操作数据缓冲区的属性特定版本。

属性请求使用以下标志之一指定要对属性执行的操作:

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

所有筛选器和引脚对象都支持对其属性执行基本支持操作。 它们是否支持获取和设置操作取决于属性。 表示筛选器或引脚对象的固有功能的属性可能仅需要获取操作。 表示可配置设置的属性可能只需要设置操作,但获取操作可能也可用于读取当前设置。 有关对音频属性使用干获取、设置和基本支持操作的详细信息,请参阅音频终结点、属性和事件

为音频驱动程序定义了以下属性集:

KSPROPSETID_AC3

KSPROPSETID_Acoustic_Echo_Cancel

KSPROPSETID_Audio

KSPROPSETID_AudioEngine

KSPROPSETID_AudioGfx

KSPROPSETID_AudioLoopback

KSPROPSETID_AudioModule

KSPROPSETID_BtAudioModule

KSPROPSETID_DirectSound3DBuffer

KSPROPSETID_DirectSound3DListener

KSPROPSETID_DrmAudioStream

KSPROPSETID_FMRXControl

KSPROPSETID_FMRXTopology

KSPROPSETID_Hrtf3d

KSPROPSETID_Itd3d

KSPROPSETID_Jack

KSPROPSETID_RTAudio

KSPROPSETID_SoundDetector

KSPROPSETID_SoundDetector2

KSPROPSETID_Synth

KSPROPSETID_SynthClock

KSPROPSETID_Synth_Dls

KSPROPSETID_Sysaudio

KSPROPSETID_Sysaudio_Pin

KSPROPSETID_TelephonyControl

KSPROPSETID_TelephonyTopology

KSPROPSETID_TopologyNode