SpatialAudioObjectRenderStreamForMetadataActivationParams 结构 (spatialaudiometadata.h)

  • 项目

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

语法

typedef struct SpatialAudioObjectRenderStreamForMetadataActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  GUID                                  MetadataFormatId;
  UINT16                                MaxMetadataItemCount;
  const PROPVARIANT                     *MetadataActivationParams;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
} SpatialAudioObjectRenderStreamForMetadataActivationParams;

成员

ObjectFormat

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

StaticObjectTypeMask

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

MinDynamicObjectCount

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

MaxDynamicObjectCount

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

Category

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

EventHandle

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

MetadataFormatId

当前活动空间呈现引擎的元数据格式的标识符。

MaxMetadataItemCount

每个帧的最大元数据项数。

MetadataActivationParams

其他激活参数。

NotifyObject

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

要求

要求 值
Header spatialaudiometadata.h