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

# XApuDisconnect

> XApuDisconnect

# XApuDisconnect

ハードウェア サーバーから切断し、[XApuConnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapuconnect.md) の間に割り当てられたすべてのリソースを解放します。

## 構文

```cpp theme={null}
HRESULT XApuDisconnect(  
         XApuHandle handle  
)  
```

### パラメーター

*handle*   \_In\_\
型: XApuHandle

[XApuConnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapuconnect.md) の呼び出しによって返されたハンドル。

### 戻り値

型: HRESULT

成功した場合は `S_OK` を返します。それ以外の場合はエラー コードを返します。

## 解説

ハードウェア サーバーからの切断に加えて、この呼び出しは [XApuConnectOutputParameters::baseData](https://docs.xbox.com/ja-jp/reference/audio/xapu/structs/xapuconnectoutputparameters.md) も解放し、[XApuConnectOutputParameters::resultReadyEvent](https://docs.xbox.com/ja-jp/reference/audio/xapu/structs/xapuconnectoutputparameters.md) ハンドルを閉じます。

キューに入れられたすべてのコマンドが処理される前に [XApuDisconnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapudisconnect.md) が呼び出された場合、すべてのリソースを解放し、エラー コード [XAPU\_E\_PENDING\_RESULTS](https://docs.xbox.com/ja-jp/reference/audio/xapu/enums/xapuerrors.md) を返します。

[XApuDisconnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapudisconnect.md) を呼び出す前に、呼び出し側は最後にキューに入れられたコマンドの結果を待機する必要があります。そうしないと、ハードウェア内で重大な障害が発生し、他のアクティブな XAPU クライアントを無効にする可能性があります。

ストリームを開始および停止するために [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) を頻繁に呼び出すことはお勧めしません。これらの呼び出しは時間がかかり、メモリの断片化によりリソース損失を引き起こす可能性もあるためです。代わりに、[XapuConnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapuconnect.md) はストリーミング セッションの初期化時に一度だけ呼び出し、ストリーミング中のストリームの開始と停止には [XApuCommandType::Activate](https://docs.xbox.com/ja-jp/reference/audio/xapu/enums/xapucommandtype.md) と [XApuCommandType::Deactivate](https://docs.xbox.com/ja-jp/reference/audio/xapu/enums/xapucommandtype.md) を使用する必要があります。ストリーミング セッションの終了時には [XApuDisconnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapudisconnect.md) を呼び出す必要があります。これはすべての XAPU クライアントに当てはまります。

## 要件

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

**ライブラリ:** xapu.lib

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

## 概念ドキュメント

* [XAPU の概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xapu-overview.md)

## 関連項目

[XApuConnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapudisconnect.md)\
[XAPU](https://docs.xbox.com/ja-jp/reference/audio/xapu/xapu_members.md)


## Related topics

- [XApuConnect](https://docs.xbox.com/ja-jp/reference/audio/xapu/functions/xapuconnect.md)
- [XApuConnectOutputParameters](https://docs.xbox.com/ja-jp/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [XAPU API を使用したシングル ストリーム Opus オーディオ デコード](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xapu-overview-single-stream-audio-decode.md)
- [XAPU](https://docs.xbox.com/ja-jp/reference/audio/xapu/xapu_members.md)
- [XAPU の概要](https://docs.xbox.com/ja-jp/build/console-features/audio/overviews/xapu-overview.md)