KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED, est une nouvelle propriété KS qui a été ajoutée à la propriété KSPROPSETID_Audio définie dans Windows 8.1.

La demande de propriété KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED transmet la préférence de limite de niveau de volume d’un utilisateur final au pilote sous-jacent. L’étendue de cette propriété est par broche (ou par point de terminaison audio, du point de vue d’un utilisateur final).

Tableau récapitulatif de l’utilisation

Obtenir	Définissez	Cible	Type de descripteur de propriété	Type de valeur de propriété
Non	Oui	Épingler instance	KSP_PIN	BOOL

La valeur de la propriété est de type BOOL et indique si un utilisateur final autorise le volume maximal à dépasser une certaine limite. La valeur TRUE indique qu’un utilisateur final a autorisé le niveau de volume à dépasser la limite affichée, tandis que FALSE indique le contraire. Dans le cas d’un compte enfant, la valeur est toujours FALSE.

Le pilote stocke la valeur de cette propriété dans une variable interne et initialise la valeur true au démarrage. Bien que cette propriété ait la valeur TRUE, le pilote limite le niveau de volume maximal. Lorsque la propriété est définie sur FALSE, le pilote peut supprimer ces limites.

Le pilote peut également modifier automatiquement la valeur de cette propriété. Par exemple, le pilote peut automatiquement basculer la valeur de la propriété de TRUE vers FALSE, puis commencer à limiter le niveau de volume après l’expiration d’un certain temps au-delà de certains niveaux sonores.

Chaque fois que la valeur de la propriété change, qu’elle soit automatique ou en raison d’un appelant définissant la valeur de la propriété, le pilote doit générer l’événement KSEVENT_PINCAPS_VOLUMELIMITCHANGE.

Valeur de retour

La demande de propriété KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED retourne STATUS_SUCCESS lorsque la demande réussit.

Spécifications

Version	Windows 8.1
En-tête	Ksmedia.h (inclure Ksmedia.h)