> ## 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/ko/reference/audio/xapu/functions/xapuconnect.md) 중에 할당된 모든 리소스를 해제합니다.

## Syntax

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

### Parameters

*handle*   \_In\_\
Type: XApuHandle

[XApuConnect](https://docs.xbox.com/ko/reference/audio/xapu/functions/xapuconnect.md)를 호출하여 반환된 핸들입니다.

### Return value

Type: HRESULT

성공 시 `S_OK`를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

## Remarks

하드웨어 서버와의 연결을 끊는 것 외에도, 이 호출은 [XApuConnectOutputParameters::baseData](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapuconnectoutputparameters.md)를 해제하고 [XApuConnectOutputParameters::resultReadyEvent](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapuconnectoutputparameters.md) 핸들을 닫습니다.

큐에 있는 모든 명령이 처리되기 전에 [XApuDisconnect](https://docs.xbox.com/ko/reference/audio/xapu/functions/xapudisconnect.md)가 호출되면 모든 리소스를 해제하고 이 오류 코드 [XAPU\_E\_PENDING\_RESULTS](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapuerrors.md)를 반환합니다.

호출자는 [XApuDisconnect](https://docs.xbox.com/ko/reference/audio/xapu/functions/xapudisconnect.md)를 호출하기 전에 큐에 있는 마지막 명령의 결과를 기다려야 합니다. 그렇지 않으면 하드웨어에서 심각한 오류가 발생하여 다른 활성 XAPU 클라이언트가 비활성화될 수 있습니다.

스트림을 시작하고 중지하기 위해 [XapuConnect](https://docs.xbox.com/ko/reference/audio/xapu/functions/xapuconnect.md) 및 [XApuDisconnect](https://docs.xbox.com/ko/reference/audio/xapu/functions/xapudisconnect.md)를 자주 호출하는 것은 권장되지 않습니다. 이러한 호출은 시간이 많이 걸리고 메모리 단편화로 인한 리소스 손실을 초래할 수도 있기 때문입니다. 대신 스트리밍 세션 초기화 시 [XapuConnect](https://docs.xbox.com/ko/reference/audio/xapu/functions/xapuconnect.md)를 한 번 호출한 다음, 스트리밍 중에 스트림을 시작하고 중지하기 위해 [XApuCommandType::Activate](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapucommandtype.md) 및 [XApuCommandType::Deactivate](https://docs.xbox.com/ko/reference/audio/xapu/enums/xapucommandtype.md)를 사용해야 합니다. 스트리밍 세션이 끝나면 [XApuDisconnect](https://docs.xbox.com/ko/reference/audio/xapu/functions/xapudisconnect.md)를 호출해야 합니다. 이는 모든 XAPU 클라이언트에 적용됩니다.

## Requirements

**Header:** xapu.h

**Library:** xapu.lib

**Supported platforms:** XBOX Series X|S

## Conceptual documentation

* [XAPU 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xapu-overview.md)

## See also

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


## Related topics

- [XApuConnect](https://docs.xbox.com/ko/reference/audio/xapu/functions/xapuconnect.md)
- [XApuConnectOutputParameters](https://docs.xbox.com/ko/reference/audio/xapu/structs/xapuconnectoutputparameters.md)
- [XAPU API를 사용한 싱글 스트림 Opus 오디오 디코딩](https://docs.xbox.com/ko/build/console-features/audio/overviews/xapu-overview-single-stream-audio-decode.md)
- [XAPU](https://docs.xbox.com/ko/reference/audio/xapu/xapu_members.md)
- [XAPU 개요](https://docs.xbox.com/ko/build/console-features/audio/overviews/xapu-overview.md)