IDirectSound3DListener8 インターフェイス
IDirectSound3DListener8 インターフェイスは、3D 空間におけるリスナーの位置・向き・環境を記述するパラメータを取得および設定するため使用される。
インターフェイスは、DSBCAPS_CTRL3D フラグを指定して作成されたプライマリ バッファで、IDirectSoundBuffer8::QueryInterface メソッドを呼び出すことで取得できる。
IUnknown から継承するメソッドのほかに、IDirectSound3DListener8 インターフェイスでは、カテゴリ別に示す以下のメソッドが公開されている。
バッチ パラメータ
| メソッド | 説明 |
| CommitDeferredSettings | このメソッドを最後に呼び出した後で行われた遅延設定をコミットする。 |
| GetAllParameters | サウンド環境とリスナーのすべての 3D パラメータを取得する。 |
| SetAllParameters | サウンド環境とリスナーのすべての 3D パラメータを設定する。 |
サウンドのグローバル プロパティ
| メソッド | 説明 |
| GetDistanceFactor | 距離係数を取得する。距離係数は、1 ベクトル単位におけるメートル数である。 |
| GetDopplerFactor | ドップラー効果に対する乗数を取得する。 |
| GetRolloffFactor | 距離に応じた減衰率を決定するロールオフ係数を取得する。 |
| SetDistanceFactor | 距離係数を設定する。 |
| SetDopplerFactor | ドップラー効果に対する乗数を設定する。 |
| SetRolloffFactor | ロールオフ係数を設定する。 |
リスナーのプロパティ
| メソッド | 説明 |
| GetOrientation | リスナーの頭部の向きを取得する。 |
| GetPosition | リスナーの位置を取得する。 |
| GetVelocity | リスナーの速度を取得する。 |
| SetOrientation | リスナーの頭部の向きを設定する。 |
| SetPosition | リスナーの位置を設定する。 |
| SetVelocity | リスナーの速度を設定する。 |
LPDIRECTSOUND3DLISTENER 型は、IDirectSound3DListener インターフェイスへのポインタとして定義されている。
typedef struct IDirectSound3DListener *LPDIRECTSOUND3DLISTENER;
要件
** ヘッダー:**dsound.h で宣言。
参照