KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED 是已添加到 Windows 8.1 中 KSPROPSETID_Audio 属性集的新 KS 属性。

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED 属性请求将最终用户的音量级别限制首选项传递给基础驱动程序。 此属性的范围是每个引脚（或每个音频终结点，从最终用户的角度来看）。

使用情况摘要表

获取	设置	目标	属性描述符类型	属性值类型
否	是	引脚实例	KSP_PIN	BOOL

属性值的类型为 BOOL，它指示最终用户是否允许最大音量超过特定限制。 TRUE 值表示最终用户允许音量级别超过发布的限制，而 FALSE 则表示相反。 对于子帐户，该值始终为 FALSE。

驱动程序将此属性的值存储在内部变量中，并在启动期间将该值初始化为 TRUE。 虽然此属性为 TRUE，但驱动程序会限制最大音量级别。 将属性设置为 FALSE 时，驱动程序可以删除这些限制。

驱动程序还可以自动更改此属性的值。 例如，驱动程序可以自动将属性值从 TRUE 切换到 FALSE，然后在超过某些声音级别的某些时间之后开始限制音量级别。

每当属性的值发生更改时，无论它是自动的还是由于调用方设置属性值，驱动程序都应生成 KSEVENT_PINCAPS_VOLUMELIMITCHANGE 事件。

返回值

当请求成功时，KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED 属性请求返回 STATUS_SUCCESS。

要求

版本	Windows 8.1
标头	Ksmedia.h（包括 Ksmedia.h）