IDirectSound3DBuffer8::SetConeAngles
サウンド プロジェクション コーンの内部角度と外部角度を設定する。
構文
HRESULT SetConeAngles(
DWORD
dwInsideConeAngle
,
DWORD
dwOutsideConeAngle
,
DWORD
dwApply
);
パラメータ
dwInsideConeAngle
コーンの内部角度 (単位は度)。この角度の内側では、サウンドは通常のボリュームである。
dwOutsideConeAngle
コーンの外部角度 (単位は度)。この角度の外側では、サウンドは外部ボリュームである。
dwApply
設定を適用するタイミングを示す値。次の値のいずれかでなければならない。
値 | 説明 |
DS3D_DEFERRED | アプリケーションが IDirectSound3DListener8::CommitDeferredSettings メソッドを呼び出すまで、設定は適用されない。複数の設定を変更した後、1 回の再計算でそれらを適用できる。 |
DS3D_IMMEDIATE | 設定を直ちに適用し、システムはすべての 3D サウンド バッファの 3D 座標を再計算する。 |
戻り値
成功した場合は DS_OK を返す。
失敗した場合は DSERR_INVALIDPARAM を返す。
注意
最小・最大・デフォルトの各コーン角度は、dsound.h において、それぞれ DS3D_MINCONEANGLE、DS3D_MAXCONEANGLE、DS3D_DEFAULTCONEANGLE として定義されている。各角度の範囲は、0° (コーンなし) から 360° (全範囲) までである。デフォルト値は 360 である。
要件
** ヘッダー:**dsound.h で宣言。
参照