> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XDspActivationParameters

> XDspActivationParameters

# XDspActivationParameters

XDSP 激活参数。

## 语法

```cpp theme={null}
typedef struct XDspActivationParameters {  
    XDspProcessType type;  
    XDspActivationOptions options;  
    uint32_t blockFrameCount;  
    uint32_t channelCount;  
    uint32_t impulseResponseLengthInFloats;  
    float* impulseResponse;  
} XDspActivationParameters  
```

### 成员

*type*\
类型：[XDspProcessType](/reference/audio/xdspaudio/enums/xdspprocesstype)

每次激活仅有一种有效的处理类型。例如，如果需要正向和逆向 FFT，则必须激活两个 XDSP 流，每种类型各一个。

*options*\
类型：[XDspActivationOptions](/reference/audio/xdspaudio/enums/xdspactivationoptions)

激活选项。

*blockFrameCount*\
类型：uint32\_t

通过 [XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand) 传递给 XDSP 的每个输入和输出数据块的帧数。此值必须为 2 的幂。对于 [XDspProcessType::Convolution](/reference/audio/xdspaudio/enums/xdspprocesstype)，支持的值为 512 和 1024。对于 [XDspProcessType::ForwardFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype) 和 [XDspProcessType::InverseFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype)，支持的值为 512、1024 和 2048。

*channelCount*\
类型：uint32\_t

对于 [XDspProcessType::Convolution](/reference/audio/xdspaudio/enums/xdspprocesstype)，单声道输入流为 1，立体声输入流为 2。对于 [XDspProcessType::ForwardFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype) 和 [XDspProcessType::InverseFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype)，此值应始终设置为 1。

*impulseResponseLengthInFloats*\
类型：uint32\_t

在 [XDspProcessType::Convolution](/reference/audio/xdspaudio/enums/xdspprocesstype) 处理期间要使用的脉冲响应长度（以 float 为单位）。例如，如果脉冲响应包含 `N` 个复数 float 值对采样，则此值应设置为 `N * 2`，因为每个复数 float 值对使用两个 float 表示。对于 [XDspProcessType::ForwardFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype) 和 [XDspProcessType::InverseFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype)，此参数必须为零。

*impulseResponse*\
类型：float\*

长度为 (`impulseResponseLengthInFloats * sizeof(float)`) 字节的缓冲区，将脉冲响应保存为一系列复数 float 值（实部和虚部值对）。也就是说，缓冲区将包含 (`impulseResponseLengthInFloats / 2`) 个复数 float 值对。如果设置了 [XDspActivationOptions::StereoImpulseResponse](/reference/audio/xdspaudio/enums/xdspactivationoptions) 且 [XDspActivationParameters::channelCount](/reference/audio/xdspaudio/structs/xdspactivationparameters) 等于 2，则缓冲区长度必须为 (`impulseResponseLengthInFloats * sizeof(float) * channelCount`) 字节。对于 [XDspProcessType::ForwardFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype) 和 [XDspProcessType::InverseFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype)，此参数必须设置为 nullptr。此缓冲区不必来自 [XDspConnect](/reference/audio/xdspaudio/functions/xdspconnect) 注册的 *baseBuffer*。

## 要求

**头文件：** XDspAudio.h

**支持的平台：** XBOX Series X|S

## 概念文档

* [XDSP 脉冲响应缩减概述](/build/console-features/audio/overviews/xdsp-overview-ir-reduction)
* [使用 XDSP API 进行带包络的单流卷积概述](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [使用 XDSP API 进行单流卷积概述](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)

## 另请参阅

[XDSP](/reference/audio/xdspaudio/xdspaudio_members)\
[XDspProcessType](/reference/audio/xdspaudio/enums/xdspprocesstype)\
[XDspActivationOptions](/reference/audio/xdspaudio/enums/xdspactivationoptions)\
[XDspSubmitCommand](/reference/audio/xdspaudio/functions/xdspsubmitcommand)\
[XDspActivationParameters](/reference/audio/xdspaudio/structs/xdspactivationparameters)\
[XDspConnect](/reference/audio/xdspaudio/functions/xdspconnect)\
[使用 XDSP API 进行单流卷积概述](/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[使用 XDSP API 进行单流 FFT/IFFT 概述](/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)


## Related topics

- [XDspActivationOptions](/zh-CN/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspActivate](/zh-CN/reference/audio/xdspaudio/functions/xdspactivate.md)
- [XDspProcessType](/zh-CN/reference/audio/xdspaudio/enums/xdspprocesstype.md)
- [XDspCommand](/zh-CN/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDSP 脉冲响应压缩概述](/zh-CN/build/console-features/audio/overviews/xdsp-overview-ir-reduction.md)