SpatialAudioObjectRenderStreamActivationParams 结构 (spatialaudioclient.h)

表示空间音频呈现流的激活参数。 激活流时,将此结构传递给 ISpatialAudioClient::ActivateSpatialAudioStream

语法

typedef struct SpatialAudioObjectRenderStreamActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
} SpatialAudioObjectRenderStreamActivationParams;

成员

ObjectFormat

单个空间音频对象的格式描述符。 流使用的所有对象必须具有相同的格式,并且格式的类型必须为 WAVEFORMATEXWAVEFORMATEXTENSIBLE

StaticObjectTypeMask

AudioObjectType 值的按位组合,指示激活的流将允许的静态空间音频通道集。

MinDynamicObjectCount

并发动态对象的最小数量。 如果无法同时激活此数量的动态音频对象, ISpatialAudioClient::ActivateSpatialAudioStream 将失败并 SPTLAUDCLNT_E_NO_MORE_OBJECTS此错误。

MaxDynamicObjectCount

可以使用 ISpatialAudioObjectRenderStream 激活的最大并发动态对象数。

Category

音频流的类别及其空间音频对象。

EventHandle

将向客户端发出信号以提供更多音频数据的事件。 此句柄将在内部复制,然后再使用它。

NotifyObject

为空间音频客户端提供通知以响应 ISpatialAudioObjectRenderStream 状态更改的 对象。 此对象用于通知客户端可同时激活的动态空间音频对象的数量即将更改。

要求

   
标头 spatialaudioclient.h