spatialAudioObjectRenderStreamActivationParams2 结构 (spatialaudioclient.h)

表示空间音频呈现流的激活参数,扩展 SpatialAudioObjectRenderStreamActivationParams (spatialaudioclient.h) ,并能够指定流选项。 激活流时,将此结构传递给 ISpatialAudioClient::ActivateSpatialAudioStream

语法

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

成员

ObjectFormat

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

StaticObjectTypeMask

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

MinDynamicObjectCount

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

MaxDynamicObjectCount

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

Category

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

EventHandle

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

NotifyObject

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

Options

SPATIAL_AUDIO_STREAM_OPTIONS的一个成员,用于指定已激活音频流的选项。

要求

要求
最低受支持的客户端 Windows 内部版本 22000
标头 spatialaudioclient.h