IDirectSound3DBuffer8::SetConeOutsideVolume
サウンド プロジェクション コーンの外部角度の外側のサウンドのボリュームを設定する。
構文
HRESULT SetConeOutsideVolume(
LONG
lConeOutsideVolume
,
DWORD
dwApply
);
パラメータ
lConeOutsideVolume
コーンの外部のボリューム。1/100 dB (デシベル) 単位で指定する。
dwApply
設定を適用するタイミングを指定する値。次の表の値のいずれかを指定しなければならない。
値 | 説明 |
DS3D_DEFERRED | アプリケーションが IDirectSound3DListener8::CommitDeferredSettings メソッドを呼び出すまで、設定は適用されない。複数の設定を変更した後、1 回の再計算でそれらを適用できる。 |
DS3D_IMMEDIATE | 設定を直ちに適用し、システムはすべての 3D サウンド バッファの 3D 座標を再計算する。 |
戻り値
成功した場合は DS_OK を返す。
失敗した場合は DSERR_INVALIDPARAM を返す。
注意
ボリューム レベルは減衰によって表される。設定可能な値は、DSBVOLUME_MAX (減衰なし) と DSBVOLUME_MIN (無音) の間である。デフォルト値は、DS3D_DEFAULTCONEOUTSIDEVOLUME (減衰なし) である。これらの値は dsound.h 内で定義されている。DirectSound は増幅をサポートしていない。
要件
** ヘッダー:**dsound.h で宣言。
参照