ISpatialAudioClient::GetStaticObjectPosition メソッド (spatialaudioclient.h)

指定した静的空間オーディオチャネルの 3D 空間内の位置を取得します。

構文

HRESULT GetStaticObjectPosition(
  [in]  AudioObjectType type,
  [out] float           *x,
  [out] float           *y,
  [out] float           *z
);

[in] type

位置のクエリを実行する静的空間オーディオチャネルを示す値。値が静的チャネル ( AudioObjectType_DynamicやAudioObjectType_None を含む) を表していない場合、このメソッドは E_INVALIDARGを返します。

[out] x

リスナーに対する静的オーディオチャネルの x 座標 (メートル単位)。正の値はリスナーの右側にあり、負の値は左側にあります。

[out] y

リスナーに対する静的オーディオチャネルの y 座標 (メートル単位)。正の値はリスナーの上にあり、負の値は以下です。

[out] z

リスナーに対する静的オーディオチャネルの z 座標 (メートル単位)。正の値はリスナーの背後にあり、負の値は前面にあります。

メソッドが成功した場合は、S_OK を返します。エラーが発生した場合、次の表に示す値が、可能なリターンコードに含まれますが、これらに限定されません。

リターンコード	説明
E_INVALIDARG	指定された AudioObjectType 値は、静的チャネルを表しません。

位置の値は右利きのデカルト座標系を使用します。各単位は 1 メートルを表します。座標系は、原点 (x=0.0, y=0.0, z=0.0) がリスナーの耳間の中心点を表すリスナーに対する相対位置です。


対象プラットフォーム	Windows
ヘッダー	spatialaudioclient.h