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