KSPROPERTY_AUDIO_EQ_LEVEL
KSPROPERTY_AUDIO_EQ_LEVEL プロパティは、n 個の周波数帯域のエントリを含むイコライゼーション テーブルのイコライゼーション レベルを指定します。 これは、EQ ノード (KSNODETYPE_EQUALIZER) 内のチャンネルのプロパティです。
用法の要点テーブル
| Yammer の入手 | 設定 | 移行先 | プロパティ記述子の種類 | プロパティ値の種類 |
|---|---|---|---|---|
はい |
Yes |
Assert |
LONG 配列 |
プロパティ値 (操作データ) は、LONG 要素の配列です。
LONG Level[N];
チャンネルのイコライゼーション テーブルに N 個の周波数帯域のエントリが含まれている場合、配列には N 個の要素が含まれており、各要素はイコライゼーション テーブルの帯域の 1 つに対してレベルを指定します。 配列要素への帯域の割り当てを次のテーブルに示します。
Array Element Description Level[0]
帯域 0 のレベル。
Level[1]
帯域 1 のレベル。
...
Level[N-1]
帯域 N-1 のレベル。
レベルの値では、次のスケールを使用します。
-2147483648 は -Infinity デシベル (減衰)、
-2147483647 は -32767.99998474 デシベル (減衰)、および
+2147483647 は +32767.99998474 デシベル (ゲイン) です。
-2147483648 から +2147483647 の整数値で表されるデシベル範囲で、ここでは
このスケールの解像度は 1/65536 デシベルです。
戻り値
KSPROPERTY_AUDIO_EQ_LEVEL プロパティ要求は、正常に完了したことを示すために STATUS_SUCCESS を返します。 それ以外の場合、要求は適切なエラー状態コードを返します。
解説
フィルターにより、フィルターの範囲を超える値を指定する KSPROPERTY_AUDIO_EQ_LEVEL set-property 要求は成功しますが、サポートされている範囲に値はクランプされます。 ただし、このプロパティを取得する後続の要求では、使用された実際の値が出力されます。
イコライゼーション帯域の番号を決定するには、最初にKSPROPERTY_AUDIO_NUM_EQ_BANDS 要求を送信します。
イコライゼーション帯域の中心周波数は、KSPROPERTY_AUDIO_EQ_BANDS プロパティによって指定されます。
要件
ヘッダー |
ksmedia.h (Ksmedia.h をインクルード) |