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

# XGameStreamingGetConnectionState

> XGameStreamingGetConnectionState

# XGameStreamingGetConnectionState

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

## 語法

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

### 參數

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

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

### 傳回值

類型：[XGameStreamingConnectionState](/zh-TW/reference/system/xgamestreaming/enums/xgamestreamingconnectionstate)

## 備註

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

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

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

## 需求

**標頭：** xgamestreaming.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

[XGameStreamingIsStreaming](/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingisstreaming)\
[XGameStreamingRegisterConnectionStateChanged](/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged)\
[XGameStreamingGetClientCount](/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount)\
[XGameStreamingGetClients](/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetclients)\
[XGameStreaming](/zh-TW/reference/system/xgamestreaming/xgamestreaming_members)


## Related topics

- [XGameStreamingGetConnectionState](/reference/system/xgamestreaming/functions/xgamestreaminggetconnectionstate.md)
- [XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members.md)