Microsoft DirectX 8.0 (C++)

IDirectSound3DListener8::GetOrientation

リスナーの向きをベクトル (前方ベクトルと上方ベクトル) で取得する。

HRESULT GetOrientation(
  D3DVECTOR * pvOrientFront, 
  D3DVECTOR * pvOrientTop 
);

パラメータ

pvOrientFront
D3DVECTOR 構造体のアドレス。この構造体はリスナーの前方ベクトルを受け取る。
pvOrientTop
D3DVECTOR 構造体のアドレス。この構造体はリスナーの上方ベクトルを受け取る。

戻り値

成功した場合は DS_OK を返す。

失敗した場合は DSERR_INVALIDPARAM を返す。

注意

前方ベクトルはリスナーの鼻の方向、上方ベクトルはリスナーの頭頂部の方向を指す。デフォルトでは、前方ベクトルは (0, 0, 1.0)、上方ベクトルは (0, 1.0, 0) である。

戻り値は必ずしも IDirectSound3DListener8::SetOrientation メソッドを使って設定したのと同じ値ではない。DirectSound は向きベクトルに調整を加えて、それらが互いに直交するようにし、両方のマグニチュードを 1.0 以下にする。

動作環境

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

参照

IDirectSound3DListener8::SetOrientation