Platform SDK: DirectX

DirectSound3DBuffer.SetPosition

DirectSound3DBuffer.SetPosition メソッドは、サウンド バッファの位置を距離単位で設定する。

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

パラメータ

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

エラー コード

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

注意

10 以上または –10 以下の値を渡すと、オーディオの限界を超えてサウンドが減衰する可能性がある。

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