音频终结点属性

头文件 Mmdeviceapi.h 定义了 Windows Vista 及更高版本中音频终结点设备的几个属性。 Windows 音频服务会设置这些属性的值。 客户端可以读取这些属性,但不应进行设置。 属性值以 PROPVARIANT 结构进行存储。

读取音频输入设备属性的推荐方法是使用 Windows.Devices.Enumeration 命名空间中的 API。 Windows 应用商店应用程序和桌面应用程序均支持这些 API。 对于使用 IMMDevice 接口读取设备属性的现有桌面应用程序,请参阅设备属性IMMDevice 不支持 Windows 应用商店应用程序。

有关如何访问音频终结点设备属性的代码示例,请参阅以下主题:

有关 PROPVARIANT的信息,请参阅 Windows SDK 文档。

以下属性是音频终结点设备特有的。

properties 说明
PKEY_AudioEndpoint_Association 将内核流式处理 (KS) 引脚类别与音频终结点设备关联。
PKEY_AudioEndpoint_ControlPanelPageProvider 指定音频终结点设备的设备属性扩展的已注册提供程序的 CLSID。
PKEY_AudioEndpoint_Disable_SysFx 表示在流向音频终结点设备或从音频终结点设备流出的共享模式流中是否启用了系统效果。
PKEY_AudioEndpoint_FormFactor 表示音频终结点设备的物理属性。
PKEY_AudioEndpoint_FullRangeSpeakers 为连接到音频终结点设备的全频扬声器指定通道配置掩码。
PKEY_AudioEndpoint_GUID 提供与音频终结点设备相对应的 DirectSound 设备标识符。
PKEY_AudioEndpoint_PhysicalSpeakers 定义音频终结点设备的物理扬声器配置。
PKEY_AudioEngine_DeviceFormat 指定设备格式,即音频引擎用于流向音频终结点设备或从音频终结点设备流出的共享模式流的格式。
PKEY_AudioEngine_OEMFormat 指定用于呈现或捕获流的设备的默认格式。 这些值由 OEM 在 .inf 文件中填充。
PKEY_AudioEndpoint_Supports_EventDriven_Mode 表示终结点是否支持事件驱动的模式。 这些值由 OEM 在 .inf 文件中填充。
PKEY_AudioEndpoint_JackSubType 包含音频终结点设备的输出类别 GUID。

核心音频 API 支持其他属性,这些属性并非只适用于音频终结点设备。 有关这些附加属性的详细信息,请参阅设备属性

音频终结点设备

编程参考