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

# XGameStreaming

> XGameStreaming

# XGameStreaming

## Inicialização

APIs necessárias para inicializar os recursos de streaming de jogos.

| Função | Descrição |
| :- | :- |
| [XGameStreamingInitialize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminginitialize) | Inicializa as APIs de streaming de jogos. |
| [XGameStreamingUninitialize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminguninitialize) | Cancela a inicialização das APIs de streaming de jogos. |

<a id="ClientProperties" />

## Propriedades do cliente

APIs para obter propriedades dos dispositivos de streaming ou do respectivo stream do jogo

### Funções

| Função | Descrição |
| :- | :- |
| [XGameStreamingClientPropertiesChangedCallback](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingclientpropertieschangedcallback) | Notificação de quando as propriedades de um dispositivo de streaming são alteradas. |
| [XGameStreamingGetClientIPAddress](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetclientipaddress) | **Preterido.** Obtém o endereço IP do cliente de streaming. Em vez disso, use as declarações do token XSTS. |
| [XGameStreamingGetDisplayDetails](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) | Obtém os detalhes de exibição do cliente de streaming. |
| [XGameStreamingGetSessionId](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetsessionid) | Obtém a ID da sessão do cliente de streaming. |
| [XGameStreamingGetStreamPhysicalDimensions](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetstreamphysicaldimensions) | Obtém o tamanho físico do stream de vídeo conforme ele está sendo renderizado no momento no cliente de streaming. |
| [XGameStreamingGetTouchBundleVersion](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversion) | Obtém a versão do pacote de adaptação de toque que está sendo utilizado no momento no dispositivo especificado. |
| [XGameStreamingGetTouchBundleVersionNameSize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggettouchbundleversionnamesize) | Obtém o tamanho do nome da versão especificado no pacote de adaptação de toque no dispositivo especificado. |
| [XGameStreamingIsTouchInputEnabled](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingistouchinputenabled) | Verifica se um cliente enviará entradas de toque para o jogo. |
| [XGameStreamingRegisterClientPropertiesChanged](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingregisterclientpropertieschanged) | Registra um retorno de chamada a ser invocado quando qualquer uma das propriedades do dispositivo cliente de streaming for alterada. |
| [XGameStreamingUnregisterClientPropertiesChanged](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingunregisterclientpropertieschanged) | Cancela o registro de um XGameStreamingClientPropertiesChangedCallback registrado anteriormente. |

### Enumerações

| Enumeração | Descrição |
| :- | :- |
| [XGameStreamingClientProperty](/pt-BR/reference/system/xgamestreaming/enums/xgamestreamingclientproperty) | Propriedades que podem ser consultadas sobre o dispositivo cliente de streaming. |
| [XGameStreamingVideoFlags](/pt-BR/reference/system/xgamestreaming/enums/xgamestreamingvideoflags) | Recursos de vídeo disponíveis que podem ser compatíveis com o dispositivo cliente de streaming. |

### Estruturas

| Estruturas | Descrição |
| :- | :- |
| [XGameStreamingDisplayDetails](/pt-BR/reference/system/xgamestreaming/structs/xgamestreamingdisplaydetails) | Detalhes sobre a tela do dispositivo cliente de streaming. |

<a id="ConnectionState" />

## Estado da conexão

APIs necessárias para gerenciar o estado da conexão dos dispositivos clientes de streaming.

### Funções

| Função | Descrição |
| :- | :- |
| [XGameStreamingConnectionStateChangedCallback](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingconnectionstatechangedcallback) | Uma função de retorno de chamada a ser invocada sempre que o estado de um cliente de streaming conectado for alterado. |
| [XGameStreamingGetClientCount](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetclientcount) | Número de dispositivos de streaming conectados no momento. |
| [XGameStreamingGetClients](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetclients) | Obtém os identificadores de cada cliente conectado no momento. |
| [XGameStreamingGetConnectionState](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetconnectionstate) | Obtém o estado atual da conexão para o dispositivo especificado. |
| [XGameStreamingIsStreaming](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingisstreaming) | Determina se o jogo está sendo transmitido no momento. |
| [XGameStreamingRegisterConnectionStateChanged](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingregisterconnectionstatechanged) | Registra um retorno de chamada a ser invocado quando o estado da conexão de um dispositivo cliente de streaming for alterado. |
| [XGameStreamingUnregisterConnectionStateChanged](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingunregisterconnectionstatechanged) | Cancela o registro de um XGameStreamingConnectionStateChangedCallback registrado anteriormente. |

### Enumerações

| Enumeração | Descrição |
| :- | :- |
| [XGameStreamingConnectionState](/pt-BR/reference/system/xgamestreaming/enums/xgamestreamingconnectionstate) | Estados de conexão de um dispositivo cliente de streaming. |

<a id="Latency" />

## Latência

APIs para adaptar a jogabilidade à latência do streaming.

### Funções

| Função | Descrição |
| :- | :- |
| [XGameStreamingGetStreamAddedLatency](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetstreamaddedlatency) | Obtém a média recente da latência relacionada ao streaming. |
| [XGameStreamingGetLastFrameDisplayed](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetlastframedisplayed) | **Preterido.** Obtém o token do pipeline de quadros do quadro exibido mais recentemente na tela do cliente de streaming. |
| [XGameStreamingGetAssociatedFrame](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe) | **Preterido.** Obtém o token do pipeline de quadros de uma leitura de entrada específica. |

## Localização do servidor

APIs para acessar a localização a partir da qual o jogo está sendo transmitido.

### Funções

| Função | Descrição |
| :- | :- |
| [XGameStreamingGetServerLocationName](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationname) | Obtém a localização do data center do servidor de streaming. |
| [XGameStreamingGetServerLocationNameSize](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetserverlocationnamesize) | Obtém o tamanho do nome da localização do data center do servidor de streaming |

<a id="TouchAdaptation" />

## Adaptação de toque

APIs para gerenciar os layouts de controle por toque que serão expostos aos clientes de streaming apropriados.

### Funções

| Função | Descrição |
| :- | :- |
| [XGameStreamingGetGamepadPhysicality](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetgamepadphysicality) | Obtém o mapeamento de fisicalidade da entrada de uma leitura de gamepad específica. |
| [XGameStreamingHideTouchControls](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrols) | Solicita que todos os dispositivos clientes de streaming conectados ocultem o layout de toque, caso esteja visível. |
| [XGameStreamingHideTouchControlsOnClient](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminghidetouchcontrolsonclient) | Solicita que um dispositivo cliente de streaming especificado oculte o layout de toque, caso esteja visível. |
| [XGameStreamingShowTouchControlLayout](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout) | Solicita que todos os dispositivos clientes de streaming conectados mostrem um layout de toque especificado. |
| [XGameStreamingShowTouchControlLayoutOnClient](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayoutonclient) | Solicita que um dispositivo cliente de streaming conectado especificado mostre um layout de toque especificado. |
| [XGameStreamingShowTouchControlsWithStateUpdate](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdate) | Solicita que todos os dispositivos clientes de streaming conectados atualizem o estado dos controles por toque e, em seguida, mostrem um layout de toque especificado. |
| [XGameStreamingShowTouchControlsWithStateUpdateOnClient](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrolswithstateupdateonclient) | Solicita que um dispositivo cliente de streaming especificado atualize o estado dos controles por toque e, em seguida, mostre um layout de toque especificado. |
| [XGameStreamingUpdateTouchControlsState](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingupdatetouchcontrolsstate) | Atualiza o estado dos controles por toque em todos os dispositivos clientes de streaming conectados. |
| [XGameStreamingUpdateTouchControlsStateOnClient](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingupdatetouchcontrolsstateonclient) | Atualiza o estado dos controles por toque em um dispositivo cliente de streaming especificado. |

### Enumerações

| Enumeração | Descrição |
| :- | :- |
| [XGameStreamingGamepadPhysicality](/pt-BR/reference/system/xgamestreaming/enums/xgamestreaminggamepadphysicality) | Mapeamento de fisicalidade de todos os botões, direcionais e gatilhos de um Controle Sem Fio XBOX padrão.  Para qualquer botão/direcional/gatilho, a fisicalidade pode ser desconhecida, física, virtual ou ambas. |
| [XGameStreamingTouchControlsStateOperationKind](/pt-BR/reference/system/xgamestreaming/enums/xgamestreamingtouchcontrolsstateoperationkind) | Operações que podem ser executadas ao atualizar o estado do layout de controle por toque. |
| [XGameStreamingTouchControlsStateValueKind](/pt-BR/reference/system/xgamestreaming/enums/xgamestreamingtouchcontrolsstatevaluekind) | Especifica o tipo do estado associado aos layouts de toque. |

### Estruturas

| Estruturas | Descrição |
| :- | :- |
| [XGameStreamingTouchControlsStateOperation](/pt-BR/reference/system/xgamestreaming/structs/xgamestreamingtouchcontrolsstateoperation) | Especifica a operação, o caminho para a variável específica e o valor a ser aplicado. |
| [XGameStreamingTouchControlsStateValue](/pt-BR/reference/system/xgamestreaming/structs/xgamestreamingtouchcontrolsstatevalue) | Fornece o tipo e o valor de um elemento específico do estado dos controles por toque. |

## Resolução

APIs para gerenciar a resolução do stream.

### Funções

| Função | Descrição |
| :- | :- |
| [XGameStreamingSetResolution](/pt-BR/reference/system/xgamestreaming/functions/xgamestreamingsetresolution) | Define a resolução do stream de vídeo. |

## Códigos de erro

Os códigos de erro a seguir podem ser retornados pelas APIs XGameStreaming. Para obter uma lista completa, consulte [Códigos de erro](/pt-BR/reference/errorcodes).

| Código | Valor | Descrição |
| - | - | - |
| 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\_GAMESTREAMING\_CLIENT\_NOT\_CONNECTED | 0x89245401 | O cliente especificado não está conectado. |
| E\_GAMESTREAMING\_NO\_DATA | 0x89245402 | Os dados solicitados não estão disponíveis. Os dados podem ficar disponíveis mais tarde. |
| E\_GAMESTREAMING\_NO\_DATACENTER | 0x89245403 | O computador atual não está sendo executado em um data center. |
| E\_GAMESTREAMING\_NOT\_STREAMING\_CONTROLLER | 0x89245404 | A leitura atual não veio de um controle de streaming. |

## Documentação conceitual

* [Chamadas de API com reconhecimento de nuvem](/pt-BR/build/core-features/common/game-streaming/game-streaming-am-i-streaming)
* [Introdução ao toque](/pt-BR/build/core-features/common/game-streaming/game-streaming-getting-started-with-touch)
* [Análise detalhada da compensação de latência do streaming de jogos](/pt-BR/build/core-features/common/game-streaming/game-streaming-latency-compensation-deep-dive)
* [Visão geral da compensação de latência do streaming de jogos](/pt-BR/build/core-features/common/game-streaming/game-streaming-latency-compensation-overview)
* [Medição de latência do streaming de jogos](/pt-BR/build/core-features/common/game-streaming/game-streaming-latency-measurement)

## Confira também

[Referência da API do sistema](/pt-BR/reference/system/gc-reference-system-toc)


## Related topics

- [XGameStreaming](/reference/system/xgamestreaming/xgamestreaming_members.md)
- [XGameStreamingIsStreaming](/reference/system/xgamestreaming/functions/xgamestreamingisstreaming.md)
