Platform SDK: DirectX

DirectSound3DBuffer.SetVelocity

DirectSound3DBuffer.SetVelocity メソッドは、サウンド バッファの速度を設定する。

object.SetVelocity(x As Single, _
    y As Single, _
    z As Single, _
    applyFlag As CONST_DS3DAPPLYFLAGS)

パラメータ

object
DirectSound3DBuffer オブジェクトを表すオブジェクト式。
xyz
速度ベクトルの座標を表す値。浮動小数点のオーバーフローを防止するために、DirectSound がこれらの値に調整を加える可能性がある。
applyFlag
設定が適用されるタイミングを示す値。この値は、CONST_DS3DAPPLYFLAGS 列挙の定数のいずれかでなければならない。

エラー コード

失敗すればエラーが発生し、Err.NumberDSERR_INVALIDPARAM が設定される。

注意

速度はドップラー効果でのみ使われる。バッファを移動することはない。

デフォルトの計測単位はメートル/秒であるが、DirectSound3DListener.SetDistanceFactor メソッドを使って単位を変更できる。

参照

DirectSound3DBuffer.SetPositionDirectSound3DBuffer.GetVelocity