ISpatialAudioObjectForHrtf：：SetEnvironment 方法 (spatialaudiohrtf.h)

设置在为 ISpatialAudioObjectForHrtf 处理音频时模拟的声学环境类型。

语法

HRESULT SetEnvironment(
  [in] SpatialAudioHrtfEnvironmentType environment
);

参数

[in] environment

一个 值，该值指定在为 ISpatialAudioObjectForHrtf 处理音频时模拟的声学环境类型。

返回值

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

返回代码	说明
SPTLAUDCLNT_E_OUT_OF_ORDER	在调用 SetEnvironment 之前未调用 ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects。
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	在以前的音频处理阶段，已显式或隐式调用 SetEndOfStream。 如果在对 ISpatialAudioObjectrenderStreamBase：：BeginUpdatingAudioObjectrenderStream 和 ISpatialAudioObjects 的调用) 之间，系统未在音频 (处理中调用 GetBuffer，则系统将隐式调用 SetEndOfStream。

注解

如果未调用 SetEnvironment ，则使用 默认值 SpatialAudioHrtfEnvironment_Small 。

要求

要求	值
目标平台	Windows
标头	spatialaudiohrtf.h

另请参阅

ISpatialAudioObjectForHrtf