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

関連項目

ISpatialAudioClient