次の方法で共有


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 内容

関連項目

IDirectSound3DBuffer8