SetShapeDmaFloatSamples
设置标志,指示音频缓冲区中的采样是包含浮点数据还是 32 位整数数据。Syntax
Parameters
context _Inout_Type: SHAPE_DMA_CONTEXT* 指向 SHAPE_DMA_CONTEXT 结构的指针。 floatSamples
Type: bool 浮点标志:1 == 浮点数据;0 == 32 位整数数据。
Return value
Type: HRESULT HRESULT 成功或错误代码。Remarks
直接内存访问 (DMA) 系统支持读写功能,并具备浮点与整数之间的自动转换。DMA 系统使用循环缓冲区,该缓冲区包含以 128 个采样为一块的去交错采样。 DMA 处理器允许可扩展硬件音频处理引擎 (SHAPE) 将数据从混合缓冲区发送到主系统内存,并将数据从主系统提取到混合缓冲区以供进一步处理。DMA 以块为单位进行,一次传输一个音频帧的数据。为便于对块交错数据的处理,通过跳跃值指定在读取或写入采样时(从基地址开始)要跳过的系统内存中音频帧块的数量。因此,多声道流每个声道都需要一个 DMA 上下文。 音频数据采样始终以 32 位值进行读写,根据 SHAPE_DMA_CONTEXT 结构的floatConvert 标志的指定,可以是整数或浮点数。请注意,DMA 的方向(读或写)是在 DMA 命令中指定的,而不是在 DMA 上下文中。这有助于减少数据带宽的占用。DMA 引擎不具备信号处理能力,但可以执行浮点到整数(或整数到浮点)的转换。这使应用程序 CPU 能够以浮点格式处理数据采样。
Requirements
头文件: shapedmacontext.h 支持的平台: XBOX One 系列主机和 XBOX Series 主机See also
SHAPE 概述ShapeDmaContext