KSPROPERTY_AUDIO_MIC_SENSITIVITY

  • 项目

KSPROPERTY_AUDIO_MIC_SENSITIVITY 属性指定相对于全比例 (dBFS) 单位的麦克风敏感度（以分贝为单位）。

注意

从 Windows 10 版本 1803 开始，KSPROPERTY_AUDIO_MIC_SENSITIVITY 已弃用。 请改用 KSPROPERTY_AUDIO_MIC_SENSITIVITY2。

使用情况摘要表

获取

设置

目标

属性描述符类型

属性值类型

是

否

引脚实例

 KSP_PIN LONG

属性值（操作数据）的类型为 LONG，包含采用相对于 dBFS 单位的分贝的敏感度信息。 敏感度值使用以下刻度。 该值使用固定点十进制表示形式。 数据存储为 16.16 固定点值。 高 16 位用于值的整数，而较低的 16 位用于值的分数部分。

返回值

KSPROPERTY_AUDIO_MIC_SENSITIVITY 属性请求在成功完成请求后返回 STATUS_SUCCESS。 否则，请求将返回适当的错误状态代码。

注解

音频驱动程序可以为每个麦克风获取麦克风敏感度。 此属性允许从驱动程序检索此信息。

对于 Windows 10 语音识别体验（如 Cortana），若要使用不同麦克风准确检测和分析不同设备上的用户语音，OS 需要知道输入信号的某些特征。 根据这些信息，OS 可以计算有效的敏感度，并应用适当的增益来增强输入信号。 有关详细信息，请参阅语音激活。

从 Windows 10 版本 1607 开始，KSPROPERTY_AUDIO_MIC_SENSITIVITY 可用。

要求

标头

 Ksmedia.h（包括 Ksmedia.h）