ISpatialAudioClient：：GetStaticObjectPosition 方法 (spatialaudioclient.h)

取得指定靜態空間音訊通道之 3D 空間中的位置。

語法

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

參數

[in] type

值，表示正在查詢位置的靜態空間音訊通道。 如果值不代表靜態通道，則這個方法會傳回E_INVALIDARG，包括 AudioObjectType_Dynamic 和 AudioObjectType_None。

[out] x

靜態音訊通道的 x 座標，以公尺為單位，相對於接聽程式。 正值位於接聽程式的右邊，負值則位於左邊。

[out] y

靜態音訊通道的 Y 座標，以公尺為單位，相對於接聽程式。 正值高於接聽程式，而負值如下。

[out] z

靜態音訊通道的 z 座標，以公尺為單位，相對於接聽程式。 正值位於接聽程式後方，而負值則位於前面。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括但不限於下表所示的值。

備註

位置值使用右手笛卡兒座標系統，其中每個單位代表 1 公尺。 座標系統相對於接聽程式，其中原點 (x=0.0、y=0.0、z=0.0) 代表接聽程式耳機之間的中心點。

需求

另請參閱

ISpatialAudioClient