IDirectSound3DListener8

IDirectSound3DListener8 インターフェイスは、3D 空間におけるリスナーの位置、向き、および視聴環境を記述するパラメーターを取得および設定するために使用されます。

このインターフェイスを取得するには、DSBCAPS_CTRL3D フラグを指定して作成されたプライマリバッファーで、IDirectSoundBuffer8::QueryInterface メソッドを呼び出します。

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

バッチパラメーター

メソッド	説明
IDirectSound3DListener8::CommitDeferredSettings	CommitDeferredSettings メソッドは、このメソッドを最後に呼び出した後で行われた遅延設定をコミットします。
IDirectSound3DListener8::GetAllParameters	GetAllParameters メソッドは、サウンド環境とリスナーのすべての 3D パラメーターを取得します。
IDirectSound3DListener8::SetAllParameters	SetAllParameters メソッドは、サウンド環境とリスナーのすべての 3D パラメーターを設定します。

メソッド	説明
IDirectSound3DListener8::GetDistanceFactor	GetDistanceFactor メソッドは、距離係数を取得します。距離係数は、1 ベクトル単位におけるメートル数です。
IDirectSound3DListener8::GetDopplerFactor	GetDopplerFactor メソッドは、ドップラー効果に対する乗数を取得します。
IDirectSound3DListener8::GetRolloffFactor	GetRolloffFactor メソッドは、距離に応じた減衰率を算出するロールオフ係数を取得します。
IDirectSound3DListener8::SetDistanceFactor	SetDistanceFactor メソッドは、距離係数を設定します。距離係数は、1 ベクトル単位におけるメートル数です。
IDirectSound3DListener8::SetDopplerFactor	SetDopplerFactor メソッドは、ドップラー効果に対する乗数を設定します。
IDirectSound3DListener8::SetRolloffFactor	SetRolloffFactor メソッドは、距離に応じた減衰率を算出するロールオフ係数を設定します。

メソッド	説明
IDirectSound3DListener8::GetOrientation	GetOrientation メソッドは、リスナーの頭部の向きを取得します。
IDirectSound3DListener8::GetPosition	GetPosition メソッドは、リスナーの位置を取得します。
IDirectSound3DListener8::GetVelocity	GetVelocity メソッドは、リスナーの速度を取得します。
IDirectSound3DListener8::SetOrientation	SetOrientation メソッドは、リスナーの頭部の向きを設定します。
IDirectSound3DListener8::SetPosition	SetPosition メソッドは、リスナーの位置を設定します。
IDirectSound3DListener8::SetVelocity	SetVelocity メソッドは、リスナーの速度を設定します。

LPDIRECTSOUND3DLISTENER 型は、IDirectSound3DListener インターフェイスへのポインターとして定義されています。

typedef struct IDirectSound3DListener  *LPDIRECTSOUND3DLISTENER;

ヘッダー: DSound.h 宣言

ライブラリ: Dsound3d.dll 内容