Skip to main content

SHAPE_DMA_CONTEXT

直接内存访问 (DMA) 上下文结构。

语法

成员

timestamp
类型:UINT32
读取:上下文处理完成的时间戳。 reserved0
类型:UINT32
保留。 mixBufPeakMag
类型:UINT32
读取:输出混合缓冲区的峰值幅度。 peakMag
类型:UINT32
读取:输出的峰值幅度。 readPointer
类型:UINT32
读取/写入:从缓冲区起始位置起的读取指针,以每个声道的帧数或帧交错组为单位。 reserved1
类型:UINT32
保留。 writePointer
类型:UINT32
读取/写入:从缓冲区起始位置起的写入指针,以每个声道的帧数或帧交错组为单位。 reserved2
类型:UINT32
保留。 full
类型:UINT32
读取/写入:当读取指针和写入指针相等时,full 指示缓冲区为空还是已满(0 == 空,1 == 满)。 reserved3
类型:UINT32
保留。 reserved4
类型:UINT32
保留。 address
类型:UINT32
写入:缓冲区地址,按 128 个采样对齐。 numFrames
类型:UINT32
写入:numFrames + 1 等于每个声道的帧数,或系统内存 DMA 缓冲区中帧交错组的数量。值为 0 表示 1 帧。DMA 模块可以从此信息中推导出 DMA 循环缓冲区的大小。此字段在定义上下文和缓冲区时设置。 reserved5
类型:UINT32
保留。 floatConvert
类型:UINT32
写入:如果数据将被转换为浮点或从浮点转换,则为 1。如果数据为 32 位整数,则为 0。 reserved6
类型:UINT32
保留。 numChannels
类型:UINT32
写入:numChannels + 1 是缓冲区中的音频声道数。值为 0 表示 1 个声道。 reserved7
类型:UINT32
保留。 channel
类型:UINT32
写入:要读取/写入的声道。 reserved8
类型:UINT32
保留。

备注

标记为 Read 的成员由 ACP 库写入,应用程序应仅进行读取。标记为 Write 的成员由你的应用程序设置,并且不会被 ACP 库更改。标记为 Read/Write 的成员由你的应用程序设置,但可能会被 ACP 库更改。 有关流图的信息,请参阅 ACP 概述中的流图解析

要求

头文件: shapedmacontext.h 支持的平台: XBOX One 系列主机和 XBOX Series 主机

概念性文档

另请参阅

ShapeDmaContext
最后修改于 2026年8月24日