> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype.md)

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

*options*\
類型:[XDspActivationOptions](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/enums/xdspactivationoptions.md)

啟用選項。

*blockFrameCount*\
類型:uint32\_t

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

*channelCount*\
類型:uint32\_t

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

*impulseResponseLengthInFloats*\
類型:uint32\_t

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

*impulseResponse*\
類型:float\*

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

## 需求

**標頭:** XDspAudio.h

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

## 概念文件

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

## 另請參閱

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


## Related topics

- [XDspActivationOptions](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspActivate](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/functions/xdspactivate.md)
- [XDspProcessType](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/enums/xdspprocesstype.md)
- [XDspCommand](https://docs.xbox.com/zh-TW/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDSP 脈衝回應縮減概觀](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/xdsp-overview-ir-reduction.md)