KSPROPERTY_AUDIO_MIC_SNR

The KSPROPERTY_AUDIO_MIC_SNR property specifies the microphone signal to noise ratio (SNR) measured in dB units.

Usage Summary Table

Usage Summary Table

Get

Set

Target

Property descriptor type

Property value type

Yes

No

Pin Instance

KSP_PIN LONG

The property value (operation data) is of type LONG and contains the SNR information in dB units. The value uses fixed point decimal representation. The data is stored as a 16.16 fixed point value. The upper 16 bits are used for the whole number of the value and the lower 16 bits are used for the fractional portion of the value.

Return Value

A KSPROPERTY_AUDIO_MIC_SNR property request returns a STATUS_SUCCESS upon successful completion of the request. Otherwise, the request returns an appropriate error status code.

Remarks

The audio driver can obtain microphone SNR for each microphone. This property allows this information to be retrieved from driver.

For Windows 10 voice recognition experiences such as Cortana to accurately detect and analyze user’s voice on various devices with different microphones, the OS needs to know certain characteristics of the input signal. Based on that information, the OS can calculate effective sensitivity and apply appropriate gain to enhance input signal. For more information, see Voice Activation.

KSPROPERTY_AUDIO_MIC_SNR is available beginning with Windows 10, version 1607.

Requirements

Header

Ksmedia.h (include Ksmedia.h)