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::BeginUpdatingAudioObjectrenderStreamISpatialAudioObjects 的调用) 之间,系统未在音频 (处理中调用 GetBuffer,则系统将隐式调用 SetEndOfStream

注解

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

要求

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

另请参阅

ISpatialAudioObjectForHrtf