> ## 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)

各アクティベーションについて、有効な処理タイプは 1 つだけです。たとえば、順方向および逆方向の FFT が必要な場合は、それぞれのタイプに対して 1 つずつ、2 つの 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 値のペアは 2 つの float を使用して表されるためです。[XDspProcessType::ForwardFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype) および [XDspProcessType::InverseFourierTransform](/reference/audio/xdspaudio/enums/xdspprocesstype) の場合、このパラメーターは 0 でなければなりません。

*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](/ja-jp/reference/audio/xdspaudio/enums/xdspactivationoptions.md)
- [XDspActivate](/ja-jp/reference/audio/xdspaudio/functions/xdspactivate.md)
- [XDspProcessType](/ja-jp/reference/audio/xdspaudio/enums/xdspprocesstype.md)
- [XDspCommand](/ja-jp/reference/audio/xdspaudio/structs/xdspcommand.md)
- [XDSP インパルス応答低減の概要](/ja-jp/build/console-features/audio/overviews/xdsp-overview-ir-reduction.md)