KSPROPERTY_AUDIO_EQ_LEVEL
La proprietà KSPROPERTY_AUDIO_EQ_LEVEL specifica i livelli di equalizzazione per una tabella di equalizzazione che contiene voci per n bande di frequenza. Si tratta di una proprietà di un canale in un nodo EQ (KSNODETYPE_EQUALIZER).
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
|---|---|---|---|---|
Sì |
Sì |
Filtra |
Matrice LONG |
Il valore della proprietà (dati dell'operazione) è una matrice di elementi LONG:
LONG Level[N];
Se la tabella di equalizzazione del canale contiene voci per le bande di frequenza N, la matrice contiene N elementi e ogni elemento specifica il livello per una delle bande nella tabella di equalizzazione. L'assegnazione di bande agli elementi della matrice è illustrata nella tabella seguente.
Array Element Description Level[0]
Livello per banda 0.
Livello[1]
Livello per banda 1.
...
Livello[N-1]
Livello per la banda N-1.
I valori di livello usano la scala seguente:
-2147483648 è -Infinity decibels (attenuazione),
-2147483647 è -32767.99998474 decibel (attenuazione) e
+2147483647 è +32767,99998474 decibel (guadagno).
Intervallo decibel rappresentato da valori integer -2147483648 a +2147483647, dove
Questa scala ha una risoluzione di 1/65536 decibel.
Valore restituito
Una richiesta di proprietà KSPROPERTY_AUDIO_EQ_LEVEL restituisce STATUS_SUCCESS per indicare che è stata completata correttamente. In caso contrario, la richiesta restituisce un codice di stato di errore appropriato.
Commenti
Il filtro avrà esito positivo a una richiesta di KSPROPERTY_AUDIO_EQ_LEVEL set-property che specifica un valore che supera l'intervallo del filtro, ma blocca il valore all'intervallo supportato. In una richiesta successiva per ottenere questa proprietà, tuttavia, restituirà il valore effettivo usato.
Il numero di bande di equalizzazione può essere determinato inviando prima una richiesta di KSPROPERTY_AUDIO_NUM_EQ_BANDS .
Le frequenze al centro delle bande di equalizzazione vengono specificate dalla proprietà KSPROPERTY_AUDIO_EQ_BANDS .
Requisiti
Intestazione |
Ksmedia.h (include Ksmedia.h) |