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

# XApuConnectOutputParameters

> XApuConnectOutputParameters

# XApuConnectOutputParameters

[XApuConnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapuconnect.md) によって返されるパラメーター。

## 構文

```cpp theme={null}
typedef struct XApuConnectOutputParameters {  
    void* baseData;  
    HANDLE resultReadyEvent;  
} XApuConnectOutputParameters  
```

### メンバー

*baseData*\
型: void\*

[XApuConnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapuconnect.md) が成功した場合はデバイス空間にマッピングできる、割り当てられたシステム メモリのベース仮想アドレス。それ以外の場合は nullptr。呼び出し側はこのメモリを使用して入力データを渡し、出力データを取得する必要があります。また、呼び出し側は処理バッファーを設定するためにこのメモリを使用する必要があります。

このバッファーは 16 バイト境界にアラインされており、このメモリを入力、出力、処理バッファーにどのように分割するかは呼び出し側次第です。

*resultReadyEvent*\
型: HANDLE

[XApuConnectOptions::EnableResultReadyEvent](https://docs.xbox.com/ja-jp/reference/audio/xapu/enums/xapuconnectoptions.md) フラグが設定されており、[XApuConnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapuconnect.md) が成功した場合は有効な Win32 イベント ハンドル。それ以外の場合は nullptr。この Win32 イベント ハンドルは、[XApuCommandOptions::SignalOnCompletion](https://docs.xbox.com/ja-jp/reference/audio/xapu/enums/xapucommandoptions.md) フラグが設定されているコマンドの結果が準備できたときにシグナル状態になります。このシグナルは 3 ミリ秒ごとに発火するタイマーで動作しています。1 つ以上の XApuResult が準備できている場合、1 回シグナル状態になります。つまり、3 ミリ秒の間に複数の結果が準備でき、それらすべてに XApuCommandOptions::SignalOnCompletion フラグが設定されている場合、イベントは 1 回シグナル状態になります。

いくつの XApuResult が準備できているかを確認するには、イベントがシグナル状態になった後に [XApuGetResultCount](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapugetresultcount.md) を呼び出す必要があります。XAPU クライアントで複数のストリームがアクティブになっている場合は、全体的なパフォーマンスを低下させる可能性があるため、[XApuCommandOptions::SignalOnCompletion](https://docs.xbox.com/ja-jp/reference/audio/xapu/enums/xapucommandoptions.md) を設定することは推奨されません。代わりに、呼び出し側はコマンド グループに対して 1 回だけ SignalOnCompletion フラグを設定する必要があります。たとえば、特定のストリームのすべてのコマンドに対してのみ SignalOnCompletion を設定し、他のアクティブなストリームには設定しないようにします。

## 解説

`XApuConnectOutputParameter` は、`XApuConnect` によって返されるパラメーターを渡すために使用されます。`XApuConnect` は Audio Processing Unit (XAPU) のために必要なリソースを割り当てます。処理エンジンから切断し、`XApuConnect` の間に割り当てられたすべてのリソースを解放する方法の詳細については、[XApuDisconnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapudisconnect.md) を参照してください。コマンド オプションの詳細については、[XApuCommandOptions](https://docs.xbox.com/ja-jp/reference/audio/xapu/enums/xapucommandoptions.md) を参照してください。

## 要件

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

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

## 関連項目

[XApuDecodeConvertCommand](https://docs.xbox.com/ja-jp/reference/audio/xapu/structs/xapudecodeconvertcommand.md)\
[XAPU](https://docs.xbox.com/ja-jp/reference/audio/xapu/xapu_members.md)


## Related topics

- [XApuCommandOptions](https://docs.xbox.com/ja-jp/reference/audio/xapu/enums/xapucommandoptions.md)
- [XApuConnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapuconnect.md)
- [XApuDisconnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapudisconnect.md)
- [XApuConnectOptions](https://docs.xbox.com/ja-jp/reference/audio/xapu/enums/xapuconnectoptions.md)
- [XAPU](https://docs.xbox.com/ja-jp/reference/audio/xapu/xapu_members.md)