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

Obtiene el identificador de cada cliente conectado actualmente.

## Sintaxis

```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 que se devolverán en la matriz de clientes.

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

Búfer para almacenar los identificadores de los clientes conectados.

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

El número de clientes realmente escritos en la matriz de clientes.

### Valor devuelto

Tipo: HRESULT

Devuelve **S\_OK** si se realiza correctamente; de lo contrario, devuelve un código de error.

#### Posibles errores

| Código de error                    | Valor de error | Motivo del error                                                                                                                                                                                      |
| ---------------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| E\_GAMESTREAMING\_NOT\_INITIALIZED | 0x89245400     | El entorno de ejecución de XGameStreaming no se ha inicializado. Llame a [XGameStreamingInitialize](/reference/system/xgamestreaming/functions/xgamestreaminginitialize) antes de llamar a otras API. |
| E\_NOT\_SUFFICIENT\_BUFFER         | 0x7A           | El número especificado en clientCount es menor que el número de clientes conectados actualmente.                                                                                                      |

Para obtener una lista de códigos de error, consulte [Códigos de error](/reference/errorcodes).

## Comentarios

Se usa para obtener el `XGameStreamingClientId` de cada dispositivo cliente de streaming que está conectado actualmente.

Si el juego solo intenta identificar si CUALQUIER dispositivo está conectado y transmitiendo, considere la posibilidad de usar [XGameStreamingIsStreaming](/reference/system/xgamestreaming/functions/xgamestreamingisstreaming).

Si el juego necesita recibir una notificación cuando un cliente de streaming se conecta o se desconecta, considere la posibilidad de usar [XGameStreamingRegisterConnectionStateChanged](/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged).

## Requisitos

**Encabezado:** xgamestreaming.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

- [XGameStreamingGetClientCount](/es/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount.md)
- [XGameStreamingGetConnectionState](/es/reference/system/xgamestreaming/functions/xgamestreaminggetconnectionstate.md)
- [Optimización de tu juego para XBOX Game Streaming](/es/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)
- [XGameStreaming](/es/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingClientProperty](/es/reference/system/xgamestreaming/enums/xgamestreamingclientproperty.md)