KSPROPERTY_AUDIOENGINE_VOLUMELEVEL
La proprietà KSPROPERTY_AUDIOENGINE_VOLUMELEVEL specifica il livello di volume di un canale in un determinato flusso.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
Sì |
Sì |
Nodo tramite istanza di Pin |
LONG (per una richiesta Get) e KSAUDIOENGINE_VOLUMELEVEL (per una richiesta Set). |
Per una richiesta Get, 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 e possono essere associati ai valori minimi e massimi forniti nella risposta di supporto di base per questa proprietà:
-2147483648 (0x80000000 in esadecimale o LONG_MIN) è -Infinito decibel (attenuazione),
-2147483647 (0x80000001 in esadecimale o LONG_MIN + 1) è -32767.99998474 decibel (attenuazione) e
+2147483647 (0x7FFFFFFF in esadecimale o LONG_MAX) è +32767.999998474 decibel (gain).
Nota
L'intervallo decibel è rappresentato da valori integer da -2147483648 a +2147483647, dove questa scala ha una risoluzione di 1/65536 decibel.
Per una richiesta Set, il valore della proprietà è di tipo KSAUDIOENGINE_VOLUMELEVEL e specifica il livello di volume desiderato di un canale in un determinato flusso, nonché un tipo di curva e una durata della curva da applicare quando viene impostato il livello del volume. 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
La richiesta di proprietà KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS 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 di proprietà per KSPROPERTY_AUDIOENGINE_VOLUMELEVEL specifica un numero di canale. Se il flusso che passa attraverso il nodo del motore audio contiene n canali, i canali vengono numerati da 0 a n-1. Si noti anche che un valore del canale di 0xFFFFFFFF indica che la richiesta si applica a tutti i canali. Se viene effettuata una richiesta di proprietà mentre il flusso non è in uno stato in esecuzione, il livello del volume viene immediatamente impostato sul livello richiesto. Se il flusso lascia lo stato di esecuzione mentre una rampa a livello di volume è in corso, il livello del volume del flusso viene immediatamente impostato sul livello di destinazione della dissolvenza corrente. Se viene eseguita una nuova richiesta di proprietà mentre è in corso una rampa a livello di volume esistente, la nuova richiesta di rampa deve iniziare dal livello del volume corrente, ovvero il livello raggiunto dal volume raggiunto al momento dell'arrivo della nuova richiesta.
Requisiti
Versione |
Windows 8 |
Intestazione |
Ksmedia.h |