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

# 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 dans laquelle 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](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminginitialize) 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](/fr-CA/reference/errorcodes).

## Remarques

Permet d'obtenir le `XGameStreamingClientId` de chaque appareil client de diffusion en continu actuellement connecté.

Si le jeu cherche seulement à déterminer si un appareil QUELCONQUE est connecté et diffuse en continu, envisagez d'utiliser [XGameStreamingIsStreaming](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingisstreaming).

Si le jeu doit être notifié lorsqu'un client de diffusion en continu se connecte ou se déconnecte, envisagez d'utiliser [XGameStreamingRegisterConnectionStateChanged](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged).

## 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](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingisstreaming)\
[XGameStreamingRegisterConnectionStateChanged](/fr-CA/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged)\
[XGameStreamingGetClientCount](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount)\
[XGameStreaming](/fr-CA/reference/system/xgamestreaming/xgamestreaming_members)


## Related topics

- [XGameStreamingGetClients](/reference/system/xgamestreaming/functions/xgamestreaminggetclients.md)
- [XGameStreamingGetClientCount](/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount.md)
