Microsoft DirectX 8.0 (C++)

IDirectSound3DBuffer8::GetVelocity

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

HRESULT GetVelocity(
  D3DVECTOR * pvVelocity 
);

パラメータ

pvVelocity
D3DVECTOR 構造体のアドレス。この構造体はサウンド バッファの速度を受け取る。

戻り値

成功した場合は DS_OK を返す。

失敗した場合は DSERR_INVALIDPARAM を返す。

注意

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

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

動作環境

  ヘッダー : dsound.h で宣言。

参照

IDirectSound3DBuffer8::SetPositionIDirectSound3DBuffer8::SetVelocity