KSPROPERTY_AUDIO_VOLUMELEVEL
La proprietà KSPROPERTY_AUDIO_VOLUMELEVEL specifica il livello di volume di un canale in un nodo del volume (KSNODETYPE_VOLUME).
Tabella riepilogo utilizzo
Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
---|---|---|---|---|
Sì |
Sì |
Nodo tramite filtro o istanza di pin |
LONG |
Il valore della proprietà è di tipo LONG e specifica il livello di volume di un canale in un determinato flusso. I valori a livello di volume usano la scala seguente:
-2147483648 è -infinito decibel (attenuazione),
-2147483647 è -32767.99998474 decibel (attenuazione) e
+2147483647 è +32767.99998474 decibel (guadagno).
Nota
L'intervallo decibel è rappresentato da valori integer da -2147483648 a +2147483647, dove questa scala ha una risoluzione di 1/65536 decibel.
Se un valore viene specificato oltre l'intervallo del filtro, la richiesta di impostare questa proprietà avrà esito positivo. Tuttavia, il valore effettivo applicato al filtro può essere determinato solo da una chiamata Get successiva a questa proprietà.
Valore restituito
Una richiesta di proprietà KSPROPERTY_AUDIO_VOLUMELEVEL restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.
Commenti
Il descrittore della proprietà per questa proprietà specifica un numero di canale. Se il flusso che passa attraverso il nodo del volume contiene n canali, i canali vengono numerati da 0 a n-1. Per altre informazioni, vedere Esposizione di nodi multicanale.
Requisiti
Intestazione |
Ksmedia.h (includere Ksmedia.h) |
Vedere anche
Personalizzazione delle impostazioni predefinite del volume audio