> ## 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](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype)

每次啟用只有一種有效的處理類型。例如,如果需要正向和反向 FFT,則必須啟用兩個 XDSP 串流,每種類型各一個。

*options*\
類型:[XDspActivationOptions](/zh-TW/reference/audio/xdspaudio/enums/xdspactivationoptions)

啟用選項。

*blockFrameCount*\
類型:uint32\_t

將透過 [XDspSubmitCommand](/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommand) 傳遞給 XDSP 的每個輸入和輸出資料區塊的框架數目。此值必須是 2 的乘冪。[XDspProcessType::Convolution](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype) 支援的值為 512、1024。[XDspProcessType::ForwardFourierTransform](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype) 和 [XDspProcessType::InverseFourierTransform](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype) 支援的值為 512、1024、2048。

*channelCount*\
類型:uint32\_t

對於 [XDspProcessType::Convolution](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype),1 表示單聲道輸入串流,2 表示立體聲輸入串流。對於 [XDspProcessType::ForwardFourierTransform](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype) 和 [XDspProcessType::InverseFourierTransform](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype),此值應一律設定為 1。

*impulseResponseLengthInFloats*\
類型:uint32\_t

[XDspProcessType::Convolution](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype) 處理期間將使用的脈衝回應長度,以 float 為單位。例如,如果脈衝回應包含 `N` 個複數 float 值組樣本,則此值應設定為 `N * 2`,因為每個複數 float 值組都是以兩個 float 表示。對於 [XDspProcessType::ForwardFourierTransform](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype) 和 [XDspProcessType::InverseFourierTransform](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype),此參數必須為零。

*impulseResponse*\
類型:float\*

長度為 (`impulseResponseLengthInFloats * sizeof(float)`) 位元組的緩衝區,以一系列複數 float 值 (實數值和虛數值組) 保存脈衝回應。這表示緩衝區將有 (`impulseResponseLengthInFloats / 2`) 個複數 float 值組。如果已設定 [XDspActivationOptions::StereoImpulseResponse](/zh-TW/reference/audio/xdspaudio/enums/xdspactivationoptions) 且 [XDspActivationParameters::channelCount](/zh-TW/reference/audio/xdspaudio/structs/xdspactivationparameters) 等於 2,則緩衝區長度必須為 (`impulseResponseLengthInFloats * sizeof(float) * channelCount`) 位元組。對於 [XDspProcessType::ForwardFourierTransform](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype) 和 [XDspProcessType::InverseFourierTransform](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype),此參數必須設定為 nullptr。此緩衝區不需要來自 [XDspConnect](/zh-TW/reference/audio/xdspaudio/functions/xdspconnect) 所註冊的 *baseBuffer*。

## 需求

**標頭:** XDspAudio.h

**支援的平台:** XBOX Series X|S

## 概念文件

* [XDSP 脈衝回應縮減概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-ir-reduction)
* [使用 XDSP API 進行含 Envelope 的單一串流 Convolution 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution-with-envelope)
* [使用 XDSP API 進行單一串流 Convolution 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)

## 另請參閱

[XDSP](/zh-TW/reference/audio/xdspaudio/xdspaudio_members)\
[XDspProcessType](/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype)\
[XDspActivationOptions](/zh-TW/reference/audio/xdspaudio/enums/xdspactivationoptions)\
[XDspSubmitCommand](/zh-TW/reference/audio/xdspaudio/functions/xdspsubmitcommand)\
[XDspActivationParameters](/zh-TW/reference/audio/xdspaudio/structs/xdspactivationparameters)\
[XDspConnect](/zh-TW/reference/audio/xdspaudio/functions/xdspconnect)\
[使用 XDSP API 進行單一串流 Convolution 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-convolution)\
[使用 XDSP API 進行單一串流 FFT/IFFT 的概觀](/zh-TW/build/console-features/audio/overviews/xdsp-overview-single-stream-fft-ifft)


## Related topics

- [XDspActivationParameters](/reference/audio/xdspaudio/structs/xdspactivationparameters.md)
- [XDspActivationOptions](/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspActivate](/reference/audio/xdspaudio/functions/xdspactivate.md)
- [XDspCommand](/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDspProcessType](/reference/audio/xdspaudio/enums/xdspprocesstype.md)