Skip to main content

​
XDspActivate

通过从池中获取空闲的处理资源来激活 XDSP 流。每个 XDSP 客户端最多允许激活 256 个流。

​
语法

​
参数

clientHandle   _In_
类型：XDspClientHandle 通过调用 XDspConnect 获取的有效 XDSP 客户端句柄。 params   _In_
类型：XDspActivationParameters* 指向 XDspActivationParameters 结构的指针。 status   _Outptr_
类型：XDspStatus** 指向 XDspStatus 结构的指针。有关其他详细信息，请参阅备注部分。 streamHandle   _Outptr_
类型：XDspStreamHandle* 如果调用成功，则返回有效的 XDspStreamHandle。有关其他详细信息，请参阅备注部分。

​
返回值

类型：HRESULT 如果方法成功，则返回 S_OK。如果方法失败，则返回下列代码之一（部分列表）：

​
备注

此调用速度较快，因为它从池中获取资源而不是重新分配资源。 调用方必须为要执行的 XDSP 流指定 XDspProcessType。XDSP 流的实例在其生命周期内只能处理一种类型的操作。若要执行两种或更多不同的处理类型，则必须实例化两个或多个 XDSP 流实例。 在 XDspActivationParameters 结构中，调用方必须指定以下内容：
  • 激活选项。
  • 每条命令将处理的帧数，即输入和输出帧数。
  • 流的通道数。仅支持单声道和立体声输入流。
  • 对于 XDspProcessType::Convolution 处理类型，指定脉冲响应长度（以 float 为单位）。
  • 对于 XDspProcessType::Convolution 处理类型，指定作为频域值的脉冲响应。
如果调用成功，将返回一个有效的 XDspStreamHandle，用于该流的其他调用（XDspSubmitCommand、XDspSubmitCommandWithEnvelope、XDspDeactivate）。此外，如果此调用成功，还将返回一个指向 XDspStatus 的指针，可用于检查已提交命令的状态。 它可用于确定最近已处理的命令，以及已提交命令的结果是否可以被使用。 XDspStatus 还包含它所代表的 XDSP 流最近提交到硬件的命令的序号，以及第一个失败命令的序号。若为卷积处理，调用方可在此调用返回后释放脉冲响应内存。

​
要求

头文件： XDspAudio.h 库： Chad.lib 支持的平台： XBOX Series X|S

​
概念文档

​
另请参阅

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

相关主题

XDspDeactivateXDSP 概述使用 XDSP API 进行单流卷积概述使用 XDSP API 进行带包络的单流卷积XDSP audio