KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED, es una nueva propiedad KS que se ha agregado a la propiedad KSPROPSETID_Audio establecida en Windows 8.1.

La solicitud de propiedad KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED pasa la preferencia de límite de nivel de volumen del usuario final al controlador subyacente. El ámbito de esta propiedad es por patilla (o por punto de conexión de audio, desde el punto de vista de un usuario final).

Tabla de resumen de uso

Obtener	Set	Destino	Tipo de descriptor de propiedad	Tipo de valor de propiedad
No	Sí	Anclar instancia	KSP_PIN	BOOL

El valor de propiedad es de tipo BOOL y indica si un usuario final permite que el volumen máximo supere un límite determinado. Un valor true indica que un usuario final ha permitido que el nivel de volumen supere el límite publicado, mientras que FALSE indica lo contrario. En el caso de una cuenta secundaria, el valor siempre será FALSE.

El controlador almacena el valor de esta propiedad en una variable interna e inicializa el valor en TRUE durante el inicio. Aunque esta propiedad es TRUE, el controlador limita el nivel máximo de volumen. Cuando la propiedad se establece en FALSE, el controlador puede quitar estos límites.

El controlador también puede cambiar automáticamente el valor de esta propiedad. Por ejemplo, el controlador puede cambiar automáticamente el valor de la propiedad de TRUE a FALSE y, a continuación, empezar a limitar el nivel de volumen después de que haya transcurrido algún tiempo por encima de determinados niveles de sonido.

Siempre que el valor de la propiedad cambie, independientemente de si es automático o debido a que un autor de llamada establece el valor de propiedad, el controlador debe generar el evento KSEVENT_PINCAPS_VOLUMELIMITCHANGE.

Valor devuelto

La solicitud de propiedad KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED devuelve STATUS_SUCCESS cuando la solicitud se realiza correctamente.

Requisitos

Versión	Windows 8.1
Encabezado	Ksmedia.h (incluye Ksmedia.h)