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

# XGameStreamingGetConnectionState

> XGameStreamingGetConnectionState

# XGameStreamingGetConnectionState

取得指定裝置目前的連線狀態。

## 語法

```cpp theme={null}
XGameStreamingConnectionState XGameStreamingGetConnectionState(  
         XGameStreamingClientId client  
)  
```

### 參數

*client*   \_In\_\
類型：XGameStreamingClientId

要查詢其連線狀態的用戶端。

### 傳回值

類型：[XGameStreamingConnectionState](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingconnectionstate.md)

## 備註

此 API 會傳回指定用戶端的 [XGameStreamingConnectionState](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingconnectionstate.md)。這可讓您檢查裝置自遊戲上次檢查以來是否已中斷連線。

如果遊戲只是要識別是否有「任何」裝置已連線並正在串流，請考慮使用 [XGameStreamingIsStreaming](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingisstreaming.md)。

如果遊戲需要在串流用戶端連線及/或中斷連線時收到通知，請考慮使用 [XGameStreamingRegisterConnectionStateChanged](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged.md)

## 需求

**標頭：** xgamestreaming.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XGameStreamingIsStreaming](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingisstreaming.md)\
[XGameStreamingRegisterConnectionStateChanged](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged.md)\
[XGameStreamingGetClientCount](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount.md)\
[XGameStreamingGetClients](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetclients.md)\
[XGameStreaming](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/xgamestreaming_members.md)


## Related topics

- [XGameStreaming (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/xgamestreaming_members.md)
- [在 Unity 專案中使用 GDK API 的 C# 包裝函式](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XGameStreamingConnectionState](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingconnectionstate.md)
- [XGameStreamingConnectionStateChangedCallback](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingconnectionstatechangedcallback.md)
- [XGameStreamingRegisterConnectionStateChanged](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged.md)