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

# IAcpHal::Disconnect

> IAcpHal::Disconnect

# IAcpHal::Disconnect

从 ACP 断开连接。

## 语法

```cpp theme={null}
HRESULT Disconnect(  
)  
```

### 参数

### 返回值

类型:HRESULT

如果方法成功,则返回 `S_OK`。如果方法失败,则返回以下代码之一(部分列表):

| 返回代码                   | 描述           |
| ---------------------- | ------------ |
| ACP\_E\_NOT\_CONNECTED | 此实例未连接到 ACP。 |

## 备注

在调用此方法之后,只能再调用 [PopMessage](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage) 方法。如果在 [Connect](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect) 调用期间创建了消息队列,并且注册了消息类型 **ACP\_MESSAGE\_TYPE\_DISCONNECTED**,那么它将是 ACP 发送的最后一条消息。收到断开连接消息后,ACP 将不再引用该实例分配的任何资源。

## 要求

**头文件:** acphal.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[Connect](/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect)\
[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

- [IAcpHal](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/iacphal.md)
- [IAcpHal::Connect](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_connect.md)
- [IAcpHal::SubmitCommand](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand.md)
- [IAcpHal::PopMessage](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_popmessage.md)
- [IAcpHal::GetNumMessages](/zh-CN/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_getnummessages.md)