次の方法で共有


IDirectSound3DBuffer8 インターフェイス

IDirectSound3DBuffer8 インターフェイスは、3D 空間におけるサウンド バッファの位置・向き・環境を記述するパラメータの取得と設定に使う。

IDirectSound3DBuffer8 は、IDirectSound3DBuffer の定義である。2 つのインターフェイス名は入れ替え可能である。

IDirectSound3DBuffer8 インターフェイスは、DSBCAPS_CTRL3D フラグを指定して作成されたバッファから取得される。IDirectSoundBuffer8 インターフェイスからは QueryInterface メソッドを使って取得でき、オーディオパスからは IDirectMusicSegmentState8::GetObjectInPath または IDirectMusicAudioPath8::GetObjectInPath を使って取得できる。

IUnknown から継承するメソッドのほかに、IDirectSound3DBuffer8 インターフェイスでは、カテゴリ別に示す以下のメソッドが公開されている。

3D モード

メソッド 説明
GetMode 3D サウンド処理の操作モードを取得する。
SetMode 3D サウンド処理の操作モードを設定する。

バッチ パラメータ

メソッド 説明
GetAllParameters サウンド バッファのすべての 3D プロパティを取得する。
SetAllParameters サウンド バッファのすべての 3D プロパティを設定する。

最小距離と最大距離

メソッド 説明
GetMaxDistance 最大距離を取得する。これは、このバッファのサウンドがそれ以上減衰しなくなる、リスナーからの距離である。
GetMinDistance 最小距離を取得する。これは、このバッファのサウンドが減衰を始める、リスナーからの距離である。
SetMaxDistance 最大距離を設定する。
SetMinDistance 最小距離を設定する。

位置

メソッド 説明
GetPosition 音源の位置を取得する。
SetPosition 音源の位置を設定する。

サウンド プロジェクション コーン

メソッド 説明
GetConeAngles サウンド プロジェクション コーンの内部角度と外部角度を取得する。
GetConeOrientation サウンド プロジェクション コーンの向きを取得する。
GetConeOutsideVolume サウンド プロジェクション コーンの外部角度の外側のサウンドのボリュームを取得する。
SetConeAngles サウンド プロジェクション コーンの内部角度と外部角度を設定する。
SetConeOrientation サウンド プロジェクション コーンの向きを設定する。
SetConeOutsideVolume サウンド プロジェクション コーンの外部角度の外側のサウンドのボリュームを設定する。

速度

メソッド 説明
GetVelocity 音源の速度を取得する。
SetVelocity 音源の速度を設定する。

LPDIRECTSOUND3DBUFFER 型は、IDirectSound3DBuffer8 インターフェイスへのポインタとして定義されている。

typedef struct IDirectSound3DBuffer  *LPDIRECTSOUND3DBUFFER;

要件

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

参照