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 で宣言。
参照