IDirectSound3DBuffer8::SetVelocity
SetVelocity メソッドは音源の速度を設定します。
HRESULT
SetVelocity(
D3DVALUE x,
D3DVALUE y,
D3DVALUE z,
DWORD dwApply
);
パラメータ
- x
速度ベクトルの x 座標を指定する値です。デフォルトの単位はメートル/秒です。浮動小数点のオーバーフローを防ぐために、これらの値が調整される場合があります。D3DVALUE は、float として定義されています。 - y
速度ベクトルの y 座標を指定する値です。デフォルトの単位はメートル/秒です。浮動小数点のオーバーフローを防ぐために、これらの値が調整される場合があります。D3DVALUE は、float として定義されています。 - z
速度ベクトルの z 座標を指定する値です。デフォルトの単位はメートル/秒です。浮動小数点のオーバーフローを防ぐために、これらの値が調整される場合があります。D3DVALUE は、float として定義されています。 - dwApply
設定を適用するタイミングを指定する値です。次の値のいずれかでなければなりません。
戻り値
成功した場合は、DS_OK を返します。失敗した場合は、DSERR_INVALIDPARAM を返します。
解説
速度はドップラー効果の計算のみに使用されます。バッファーの位置を変更することはありません。詳細については、「ドップラー効果」を参照してください。
デフォルトの計測単位はメートル/秒ですが、SetDistanceFactor メソッドを使用して変更することができます。
要件
ヘッダー: DSound.h 宣言
ライブラリ: Dsound3d.dll 内容