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