ISpatialAudioObjectForHrtf：：SetDirectivity 方法 (spatialaudiohrtf.h)

设置 ISpatialAudioObjectForHrtf 的空间音频指向性模型。

语法

HRESULT SetDirectivity(
  SpatialAudioHrtfDirectivityUnion *directivity
);

参数

directivity

空间音频指向性模型。 此值可以是以下结构之一：

• SpatialAudioHrtfDirectivity
• SpatialAudioHrtfDirectivityCardioid
• SpatialAudioHrtfDirectivityCone

返回值

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

返回代码	说明
SPTLAUDCLNT_E_OUT_OF_ORDER	在调用 SetDirectivity 之前，未调用 ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects。
SPTLAUDCLNT_E_RESOURCES_INVALIDATED	在以前的音频处理过程中，已显式或隐式调用 SetEndOfStream。 如果未在音频处理中调用 GetBuffer，则系统会隐式调用 SetEndOfStream，并在调用 ISpatialAudioObjects 和 ISpatialAudioObjects) 之间 (。

注解

SpatialAudioHrtfDirectivity 结构表示一个全向模型，该模型可通过心形或锥体模型进行线性内插。

如果未调用 SetDirectivity ，则使用默认类型的 SpatialAudioHrtfDirectivity_OmniDirectional ，而不内插。

要求

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

另请参阅

ISpatialAudioObjectForHrtf