Skip to main content

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

概念文档

另请参阅

XDSP
XDspSubmitCommandWithEnvelope
XDSP Errors
使用 XDSP API 进行单流卷积概述
使用 XDSP API 进行单流 FFT/IFFT 概述
使用 XDSP API 进行带包络的单流卷积概述
最后修改于 2026年8月24日