KSPROPERTY_AUDIO_EQ_LEVEL

KSPROPERTY_AUDIO_EQ_LEVEL プロパティは、n 個の周波数帯域のエントリを含むイコライゼーションテーブルのイコライゼーションレベルを指定します。これは、EQ ノード (KSNODETYPE_EQUALIZER) 内のチャンネルのプロパティです。

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
はい	Yes	Assert	KSNODEPROPERTY_AUDIO_CHANNEL	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 をインクルード)