Microsoft DirectX 8.0 (C++) |
3D 空間におけるリスナーの位置、向き、および環境を記述するパラメータの取得と設定に使用する。
インターフェイスは、DSBCAPS_CTRL3D フラグで作成されたプライマリ バッファで、IDirectSoundBuffer8::QueryInterface メソッドを呼び出すことで取得できる。オーディオパスを使用するアプリケーションは、次のサンプル コードに示すように、オーディオパスからインターフェイスを取得できる。pAudiopath は IDirectMusicAudioPath8 インターフェイス ポインタである。
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 で宣言。