Platform SDK: DirectX

IDirectSound3DBuffer::GetVelocity

IDirectSound3DBuffer::GetVelocity メソッドは、サウンド バッファの現在の速度を取得する。速度は、秒速単位で計測される。デフォルトの単位はメートル/秒であるが、IDirectSound3DListener::SetDistanceFactor メソッドを使って変更できる。

HRESULT GetVelocity(
  LPD3DVECTOR lpvVelocity  
);

パラメータ

lpvVelocity
D3DVECTOR 構造体のアドレス。この構造体はサウンド バッファの現在の速度を保持する。

戻り値

成功すれば DS_OK、失敗すれば DSERR_INVALIDPARAM を返す。

注意

速度はドップラー効果でのみ使われる。実際にバッファを移動することはない。詳細については、「ドップラー係数」を参照すること。

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

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsound.h で宣言。
  インポート ライブラリ : dsound.lib を使用。

参照

IDirectSound3DBuffer::SetPositionIDirectSound3DBuffer::SetVelocity