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

Obtient l'ID de chaque client actuellement connecté.

## Syntaxe

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

### Paramètres

*clientCount*   \_In\_\
Type : uint32\_t

Nombre maximal de clients à retourner dans le tableau clients.

*clients*   \_Out\_writes\_to\_(clientCount,*clientsUsed)\
Type : XGameStreamingClientId*

Mémoire tampon destinée à stocker les ID des clients connectés.

*clientsUsed*   \_Out\_\
Type : uint32\_t\*

Nombre de clients réellement écrits dans le tableau clients.

### Valeur de retour

Type : HRESULT

Retourne **S\_OK** en cas de réussite ; sinon, retourne un code d'erreur.

#### Erreurs potentielles

| Code d'erreur | Valeur d'erreur | Cause de l'erreur |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | Le runtime XGameStreaming n'a pas été initialisé. Appelez [XGameStreamingInitialize](https://docs.xbox.com/fr/reference/system/xgamestreaming/functions/xgamestreaminginitialize.md) avant d'appeler d'autres API. |
| E\_NOT\_SUFFICIENT\_BUFFER | 0x7A | Le nombre spécifié dans clientCount est inférieur au nombre de clients actuellement connectés. |

Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](https://docs.xbox.com/fr/reference/errorcodes.md).

## Remarques

Permet d'obtenir le `XGameStreamingClientId` de chaque appareil client de streaming actuellement connecté.

Si le jeu cherche uniquement à déterminer si un appareil QUELCONQUE est connecté et en cours de streaming, envisagez d'utiliser [XGameStreamingIsStreaming](https://docs.xbox.com/fr/reference/system/xgamestreaming/functions/xgamestreamingisstreaming.md).

Si le jeu doit être notifié lorsqu'un client de streaming se connecte et/ou se déconnecte, envisagez d'utiliser [XGameStreamingRegisterConnectionStateChanged](https://docs.xbox.com/fr/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged.md).

## Configuration requise

**En-tête :** xgamestreaming.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

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


## Related topics

- [XGameStreamingGetClientCount](https://docs.xbox.com/fr/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount.md)
- [XGameStreamingGetConnectionState](https://docs.xbox.com/fr/reference/system/xgamestreaming/functions/xgamestreaminggetconnectionstate.md)
- [Bonnes pratiques de développement pour Xbox Game Streaming](https://docs.xbox.com/fr/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)
- [XGameStreaming (contenu de l'API)](https://docs.xbox.com/fr/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingGetClientIPAddress](https://docs.xbox.com/fr/reference/system/xgamestreaming/functions/xgamestreaminggetclientipaddress.md)