KSPROPERTY_AUDIOENGINE_VOLUMELEVEL

KSPROPERTY_AUDIOENGINE_VOLUMELEVEL プロパティは、特定のストリーム内のチャンネルについて音量レベルを指定します。

用法の要点テーブル

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
はい	はい	Pin インスタンス経由のノード	KSNODEPROPERTY_AUDIO_CHANNEL	LONG (Get 要求の場合) と KSAUDIOENGINE_VOLUMELEVEL (Set 要求の場合)。

Get 要求の場合、プロパティ値は LONG 型であり、特定のストリーム内のチャンネルについて音量レベルを指定します。 音量レベルの値では次のスケールを使用します。音量レベルの値は、このプロパティの Basic サポート応答で指定された最小値と最大値で囲むことができます。

-2147483648 (16 進数で 0x80000000、またはLONG_MIN) は -Infinity デシベル (減衰)、

-2147483647 (16 進数で0x80000001、または LONG_MIN + 1) は -32767.99998474 デシベル (減衰)、および

+2147483647 (16 進数で 0x7FFFFFFF、または LONG_MAX) は +32767.99998474 デシベル (ゲイン) です。

Note

デシベル範囲は、-2147483648 から +2147483647 までの整数値で表されます。この場合、このスケールの解像度は 1/65536 デシベルです。

Set 要求の場合、プロパティ値は KSAUDIOENGINE_VOLUMELEVEL型で、特定のストリーム内のチャンネルについて必要な音量レベル、および音量レベルが設定されるときに適用される曲線の種類と曲線の継続時間を指定します。 フィルターの範囲を超える値が指定された場合でも、このプロパティを設定する要求は成功します。 ただし、フィルターに適用された実際の値は、このプロパティに対する後続の Get 呼び出しによってのみ決定できます。

戻り値

KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS プロパティ要求は、正常に完了したことを示すために STATUS_SUCCESS を返します。 それ以外の場合、要求は適切なエラー状態コードを返します。

解説

KSPROPERTY_AUDIOENGINE_VOLUMELEVEL のプロパティ記述子は、チャンネル番号を指定します。 オーディオ エンジン ノードを通過するストリームに n 個のチャンネルが含まれている場合、チャンネルの番号は 0 から n-1 までになります。 また、チャンネル値 0xFFFFFFFF は、すべてのチャンネルに要求が適用されることを示します。 ストリームが実行中の状態でないときにプロパティ要求が行われた場合、音量レベルは要求されたレベルにすぐに設定されます。 音量レベルのランプの進行中にストリームが実行状態を離れると、ストリームの音量レベルは、現在のフェードのターゲット レベルにすぐに設定されます。 既存の音量レベル ランプの進行中に新しいプロパティ要求が行われると、新しいランプ要求は、現在の音量レベル (新しい要求が届いたときに音量が達していたレベル) から開始する必要があります。

要件

バージョン	Windows 8
ヘッダー	Ksmedia.h

関連項目

KSAUDIOENGINE_VOLUMELEVEL

KSNODEPROPERTY_AUDIO_CHANNEL

KSPROPERTY_AUDIOENGINE

KSPROPERTY_AUDIOENGINE_SUPPORTEDDEVICEFORMATS