Microsoft DirectX 8.0 (C++)

IDirectSound3DListener8

3D 空間におけるリスナーの位置、向き、および環境を記述するパラメータの取得と設定に使用する。

インターフェイスは、DSBCAPS_CTRL3D フラグで作成されたプライマリ バッファで、IDirectSoundBuffer8::QueryInterface メソッドを呼び出すことで取得できる。オーディオパスを使用するアプリケーションは、次のサンプル コードに示すように、オーディオパスからインターフェイスを取得できる。pAudiopathIDirectMusicAudioPath8 インターフェイス ポインタである。

IDirectSound3DListener8 *pListener;
 
pAudioPath->GetObjectInPath(0, DMUS_PATH_PRIMARY_BUFFER,
        0, GUID_All_Objects, 0, IID_IDirectSound3DListener,
        (void **)&pListener)));

IDirectSound3DListener8 インターフェイスのメソッドは、次のグループにまとめることができる。

バッチ パラメータ操作 GetAllParameters
  SetAllParameters
遅延設定 CommitDeferredSettings
距離係数 GetDistanceFactor
  SetDistanceFactor
ドップラー係数 GetDopplerFactor
  SetDopplerFactor
方向 GetOrientation
  SetOrientation
位置 GetPosition
  SetPosition
ロールオフ係数 GetRolloffFactor
  SetRolloffFactor
速度 GetVelocity
  SetVelocity

すべての COM インターフェイスと同様、IDirectSound3DListener8 インターフェイスは IUuknown インターフェイス メソッドを継承している。IUnknown インターフェイスは次の 3 つのメソッドをサポートする。

IUnknown AddRef
  QueryInterface
Release

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

typedef struct IDirectSound3DListener    *LPDIRECTSOUND3DLISTENER;

動作環境

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