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

# XApuConnectInputParameters

> XApuConnectInputParameters

# XApuConnectInputParameters

リソースを割り当てるために [XApuConnect](/reference/audio/xapu/functions/xapuconnect) に渡すパラメーター。

## 構文

```cpp theme={null}
typedef struct XApuConnectInputParameters {  
    XApuProcessType processType;  
    uint32_t maxStreamCount;  
    uint32_t maxQueuedCommandsPerStream;  
    uint32_t baseDataLength;  
    uint32_t maxFrameCountPerOutput;  
    XApuConnectOptions options;  
} XApuConnectInputParameters  
```

### メンバー

*processType*\
型: [XApuProcessType](/reference/audio/xapu/enums/xapuprocesstype)

XAPU クライアントによって処理されるすべてのストリームに対して実行される処理種別。1 つのクライアントは 2 種類以上の処理種別を実行できません。

*maxStreamCount*\
型: uint32\_t

XAPU クライアントで同時にアクティブになると想定されるストリームの最大数。最小値は 1、最大値は 500 です。

*maxQueuedCommandsPerStream*\
型: uint32\_t

1 つのストリームのコマンド キュー サイズ。最小値は 1、最大値は 16 です。XAPU クライアントの合計コマンド キュー サイズは、*maxStreamCount* \* *maxQueuedCommandsPerStream* です。

*baseDataLength*\
型: uint32\_t

*maxStreamCount* 個のストリームを処理するために必要なメモリ割り当てサイズ (バイト単位)。入力、出力、および処理バッファーを含みます。
たとえば、20 ミリ秒パケット (960 フレーム) の 1 つのステレオ Opus ストリームを DecodeOpus する場合の *baseDataLength* は、
想定される入力パケット長 (バイト単位) の最大値に、出力フレーム数 × チャネル数 × float 型変数のサイズを加えたものになります。

XApuProcessType::DecodeOpus の一般的な計算式は次のとおりです。

baseDataLength = maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float))
ここで *MaxFrameCountPerPacket* は 16 の倍数である必要があります。

[XApuProcessType::DecodeConvertOpus](/reference/audio/xapu/enums/xapuprocesstype) の一般的な計算式は次のとおりです。
baseDataLength = (maxStreamCount x maxQueuedCommandsPerStream x (MaxOpusPacketInBytes + (MaxFrameCountPerPacket x ChannelCount x sizeof(float)))

* (maxStreamCount x XApuDecodeConvertActivateCommand::processingBufferLength)
  ここで *MaxFrameCountPerPacket* は 16 の倍数である必要があります。

*maxFrameCountPerOutput*\
型: uint32\_t

このパラメーターは、XAPU が [XApuProcessType::ConvertPCM](/reference/audio/xapu/enums/xapuprocesstype) または [XApuProcessType::DecodeConvertOpus](/reference/audio/xapu/enums/xapuprocesstype) 種別で実行されているときの出力持続時間をフレーム数で定義します。
[XApuProcessType::ConvertPCM](/reference/audio/xapu/enums/xapuprocesstype) または [XApuProcessType::DecodeConvertOpus](/reference/audio/xapu/enums/xapuprocesstype) の場合、このパラメーターは 256、480、512、960、1024 のいずれかに設定する必要があります。
このパラメーターは [XApuProcessType::DecodeOpus](/reference/audio/xapu/enums/xapuprocesstype) の場合は 0 に設定する必要があります。

*options*\
型: [XApuConnectOptions](/reference/audio/xapu/enums/xapuconnectoptions)

接続オプション。

## 解説

`XApuConnectInputParameters` は、パラメーターを `XApuConnect` に渡すために使用されます。`XApuConnect` は Audio Processing Unit (XAPU) のために必要なリソースを割り当てます。`XApuCommandId` は、XAPU に送信され、XAPU から受信される基本コマンド パラメーターを定義します。

## 要件

**ヘッダー:** xapu.h

**サポートされているプラットフォーム:** XBOX Series X|S

## 関連項目

[XApuCommandId](/reference/audio/xapu/structs/xapucommandid)\
[XApuConnect](/reference/audio/xapu/functions/xapuconnect)\
[XApuDecodeConvertCommand](/reference/audio/xapu/structs/xapudecodeconvertcommand)\
[XAPU](/reference/audio/xapu/xapu_members)


## Related topics

- [XApuConnectOptions](/ja-jp/reference/audio/xapu/enums/xapuconnectoptions.md)
- [XApuConnect](/ja-jp/reference/audio/xapu/functions/xapuconnect.md)
- [XApuProcessType](/ja-jp/reference/audio/xapu/enums/xapuprocesstype.md)
- [XApuDecodeConvertActivateCommand](/ja-jp/reference/audio/xapu/structs/xapudecodeconvertactivatecommand.md)
- [XAPU](/ja-jp/reference/audio/xapu/xapu_members.md)