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

Obtém a ID de cada cliente conectado no momento.

## Sintaxe

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

### Parâmetros

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

Número máximo de clientes a serem retornados na matriz clients.

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

Buffer para armazenar as IDs dos clientes conectados.

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

O número de clientes efetivamente gravados na matriz clients.

### Valor retornado

Tipo: HRESULT

Retornará **S\_OK** se for bem-sucedido; caso contrário, retornará um código de erro.

#### Erros potenciais

| Código de erro | Valor do erro | Motivo do erro |
| - | - | - |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400 | O runtime do XGameStreaming não foi inicializado. Chame [XGameStreamingInitialize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminginitialize) antes de chamar outras APIs. |
| E\_NOT\_SUFFICIENT\_BUFFER | 0x7A | O número especificado em clientCount é menor que o número de clientes conectados no momento. |

Para obter uma lista de códigos de erro, consulte [Códigos de erro](/pt-BR/reference/errorcodes).

## Comentários

Usado para obter o `XGameStreamingClientId` de cada dispositivo cliente de streaming conectado no momento.

Se o jogo estiver apenas tentando identificar se QUALQUER dispositivo está conectado e fazendo streaming, considere usar [XGameStreamingIsStreaming](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingisstreaming).

Se o jogo precisar ser notificado quando um cliente de streaming se conectar e/ou desconectar, considere usar [XGameStreamingRegisterConnectionStateChanged](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged).

## Requisitos

**Cabeçalho:** xgamestreaming.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[XGameStreamingIsStreaming](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingisstreaming)\
[XGameStreamingRegisterConnectionStateChanged](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged)\
[XGameStreamingGetClientCount](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount)\
[XGameStreaming](/pt-BR/reference/system/xgamestreaming/xgamestreaming_members)


## Related topics

- [XGameStreamingGetClients](/reference/system/xgamestreaming/functions/xgamestreaminggetclients.md)
- [XGameStreamingGetClientCount](/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount.md)
- [XGameStreamingGetConnectionState](/reference/system/xgamestreaming/functions/xgamestreaminggetconnectionstate.md)
- [XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members.md)
- [Optimizing your game for XBOX Game Streaming](/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)