ISpatialAudioObjectForHrtf::SetOrientation 方法 (spatialaudiohrtf.h)

设置 3D 空间中相对于侦听器的引用框架的方向, ISpatialAudioObjectForHrtf 音频数据将从该帧呈现。

语法

HRESULT SetOrientation(
  [in] const SpatialAudioHrtfOrientation *orientation
);

参数

[in] orientation

定义行主 3x3 旋转矩阵的浮点数组。

返回值

如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
SPTLAUDCLNT_E_OUT_OF_ORDER

在调用 SetOrientation 之前,未调用 ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects

SPTLAUDCLNT_E_RESOURCES_INVALIDATED

在以前的音频处理过程中,已显式或隐式调用 SetEndOfStream。 如果未在音频处理中调用 GetBuffer,则系统会隐式调用 SetEndOfStream,并在调用 ISpatialAudioObjectsISpatialAudioObjects) 之间 (。

注解

如果从未调用 SetOrientation ,则使用标识矩阵的默认值。 调用 SetOrientation 后,设置的方向将用于音频对象,直到方向因另一次调用 SetOrientation 而更改。

要求

   
目标平台 Windows
标头 spatialaudiohrtf.h

另请参阅

ISpatialAudioObjectForHrtf