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

# XGameStreamingGetClients

> XGameStreamingGetClients

# XGameStreamingGetClients

取得每個目前已連線用戶端的識別碼。

## 語法

```cpp theme={null}
HRESULT XGameStreamingGetClients(  
         uint32_t clientCount,  
         XGameStreamingClientId* clients,  
         uint32_t* clientsUsed  
)  
```

### 參數

*clientCount*   \_In\_\
類型：uint32\_t

要在 clients 陣列中傳回的用戶端數目上限。

*clients*   \_Out\_writes\_to\_(clientCount,*clientsUsed)\
類型：XGameStreamingClientId*

用來儲存已連線用戶端識別碼的緩衝區。

*clientsUsed*   \_Out\_\
類型：uint32\_t\*

實際寫入 clients 陣列的用戶端數目。

### 傳回值

類型：HRESULT

如果成功，則傳回 **S\_OK**；否則傳回錯誤碼。

#### 可能的錯誤

| 錯誤碼 | 錯誤值 | 錯誤原因 |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | XGameStreaming 執行階段尚未初始化。請先呼叫 [XGameStreamingInitialize](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md)，再呼叫其他 API。 |
| E\_NOT\_SUFFICIENT\_BUFFER | 0x7A | clientCount 中指定的數目小於目前已連線的用戶端數目。 |

如需錯誤碼清單，請參閱[錯誤碼](https://docs.xbox.com/zh-TW/reference/errorcodes.md)。

## 備註

用來取得目前已連線之每個串流用戶端裝置的 `XGameStreamingClientId`。

如果遊戲只是要識別是否有「任何」裝置已連線並正在串流，請考慮使用 [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)\
[XGameStreaming](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/xgamestreaming_members.md)


## Related topics

- [XGameStreamingGetClientCount](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount.md)
- [XGameStreamingGetConnectionState](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetconnectionstate.md)
- [XBOX Game Streaming 的開發最佳做法](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)
- [XGameStreaming (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingGetClientIPAddress](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetclientipaddress.md)