XDspSubmitCommand
为给定的 XDSP 流向硬件队列提交一条命令。语法
参数
handle _In_类型:XDspStreamHandle 有效的 XDSP 流句柄。 command _In_
类型:XDspCommand* 指向 XDspCommand 结构的指针。 commandSequence _Out_
类型:uint32_t* 指向
uint32_t 的指针,用于返回命令序号值。有关其他详细信息,请参阅备注部分。
返回值
类型:HRESULT 如果方法成功,则返回 S_OK。如果方法失败,则返回下列代码(部分列表):备注
此调用速度较快,因为它不会分配资源或处理数据,仅将命令发送到硬件服务器。 此调用还接受一个指向uint32_t 的指针,用于返回命令序号值 commandSequence,以便日后跟踪命令结果何时就绪。此数字表示自会话开始以及在调用 XDspActivate 之后已成功提交的命令总数。第一条命令的数值为 1,之后每次 XDspSubmitCommand 调用成功时该数值都会加 1。
如果硬件服务器处于错误状态,XDspSubmitCommand 将返回 XDSP_E_DEVICE_FATAL_ERROR 错误代码。此时,无法为处于失败状态的 XDSP 流提交更多命令。该流对应的 XDspStatus 也将显示相同的错误。受影响的 XDSP 流应通过检查 XDspStatus 等待所有已提交的命令由硬件处理完毕,然后在所有命令处理完成后使用 XDspDeactivate 将其停用。其他 XDSP 流不会受到影响,硬件将继续处理它们的命令。
要求
头文件: XDspAudio.h 库: Chad.lib 支持的平台: XBOX Series X|S概念文档
另请参阅
XDSPXDspSubmitCommandWithEnvelope
XDSP Errors
使用 XDSP API 进行单流卷积概述
使用 XDSP API 进行单流 FFT/IFFT 概述
使用 XDSP API 进行带包络的单流卷积概述
