KSPROPERTY_AUDIO_VOLUMELEVEL

Articolo
06/15/2023

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	KSNODEPROPERTY_AUDIO_CHANNEL	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.