KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED

KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED, è una nuova proprietà KS aggiunta alla proprietà KSPROPSETID_Audio impostata in Windows 8.1.

La richiesta di proprietà KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED supera la preferenza limite del livello di volume dell'utente finale al driver sottostante. L'ambito di questa proprietà è per pin (o per endpoint audio, dal punto di vista dell'utente finale).

Tabella riepilogo utilizzo

Recupero	Set	Destinazione	Tipo di descrittore delle proprietà	Tipo di valore della proprietà
No	Sì	Istanza di pin	KSP_PIN	BOOL

Il valore della proprietà è di tipo BOOL e indica se un utente finale consente al volume massimo di superare un determinato limite. Un valore true indica che un utente finale ha consentito che il livello del volume sia superiore al limite registrato, mentre FALSE indica l'opposto. Nel caso di un account figlio, il valore sarà sempre FALSE.

Il driver archivia il valore di questa proprietà in una variabile interna e inizializza il valore su TRUE durante l'avvio. Mentre questa proprietà è TRUE, il driver limita il livello massimo di volume. Quando la proprietà è impostata su FALSE, il driver può rimuovere questi limiti.

Il driver può anche modificare automaticamente il valore di questa proprietà. Ad esempio, il driver può cambiare automaticamente il valore della proprietà da TRUE a FALSE e quindi iniziare a limitare il livello del volume dopo un certo periodo di tempo sopra determinati livelli di suono trascorsi.

Ogni volta che il valore della proprietà viene modificato, indipendentemente dal fatto che sia automatico o dovuto a un chiamante che imposta il valore della proprietà, il driver deve generare l'evento KSEVENT_PINCAPS_VOLUMELIMITCHANGE.

Valore restituito

La richiesta di proprietà KSPROPERTY_AUDIO_VOLUMELIMIT_ENGAGED restituisce STATUS_SUCCESS quando la richiesta ha esito positivo.

Requisiti

Versione	Windows 8.1
Intestazione	Ksmedia.h (includere Ksmedia.h)