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

# XApuDisconnect

> XApuDisconnect

# XApuDisconnect

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

## 構文

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

### パラメーター

*handle*   \_In\_\
型: XApuHandle

[XApuConnect](/reference/audio/xapu/functions/xapuconnect) の呼び出しによって返されたハンドル。

### 戻り値

型: HRESULT

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

## 解説

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

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

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

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

## 要件

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

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

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

## 概念ドキュメント

* [XAPU の概要](/build/console-features/audio/overviews/xapu-overview)

## 関連項目

[XApuConnect](/reference/audio/xapu/functions/xapudisconnect)\
[XAPU](/reference/audio/xapu/xapu_members)


## Related topics

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