PKEY_Devices_AudioDevice_Microphone_IsFarField

在 Windows 10 19H1 及更高版本中, PKEY_Devices_AudioDevice_Microphone_IsFarField 属性键指示麦克风是否会捕获远场音频。

从 Windows 10 19H1 开始,使用 PKEY_Devices_AudioDevice_Microphone_IsFarField 属性是支持远场音频的系统的要求,通常供语音助手使用。

值为 1 表示麦克风将捕获远场音频,这使得麦克风成为语音助手的首选终结点。

值为 0 或无属性键表示麦克风不支持远场或支持未知,因此终结点不会优先用于语音助手。

该属性应通过 INF 设置,最好是 OEM 提供的扩展 INF,而不是音频设备的基本 INF。 有关扩展 INF 文件的详细信息,请参阅创建组件化音频驱动程序安装和使用扩展 INF 文件

INF 文件示例

sysvad 示例 ComponentizedAudioSampleExtension.inf 文件包括此属性。 该示例显示设置为0x1指示麦克风捕获远场音频的值。

;HKR,EP\1,%PKEY_Devices_AudioDevice_Microphone_IsFarField%,0x00010001,0x1

要求

要求
最低受支持的客户端 Windows 10 版本 19H1
标头 Ksmedia.h

Media-Class INF 扩展