Skip to main content

XGameStreamingShowTouchControlsWithStateUpdate

Solicita que todos os dispositivos cliente de streaming conectados atualizem o estado dos controles por toque e mostrem um layout de toque especificado. Todas as atualizações de estado acontecem antes que o novo layout de toque seja exibido.

Sintaxe

Parâmetros

layout   _In_opt_z_
Tipo: char*
Nome do layout de controles por toque a ser exibido ou nullptr para exibir o layout padrão. operationCount   _In_
Tipo: size_t
Tamanho da matriz de operações que está sendo passada operations   _In_reads_opt_(operationCount)
Tipo: XGameStreamingTouchControlsStateOperation*
Matriz de todas as atualizações de variáveis de estado que estão sendo solicitadas

Valor retornado

Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro.

Erros potenciais

Comentários

Esta API deve ser usada quando o jogo precisar mostrar um layout de toque específico que também exija algumas atualizações de estado que possam afetar sua renderização. Use esta API se quiser tanto atualizar o estado das variáveis referenciadas em um novo layout de toque QUANTO alternar para esse layout de toque em todos os dispositivos cliente de streaming conectados. Esta API garante que todas as atualizações de estado sejam feitas antes que o novo layout seja exibido. Se quiser afetar apenas um cliente específico, use XGameStreamingShowTouchControlsWithStateUpdateOnClient. Se o jogo quiser apenas alterar o layout, ele deverá usar XGameStreamingShowTouchControlLayout. Se as atualizações de estado puderem afetar o layout atual ou outros layouts e as atualizações precisarem acontecer independentemente de uma alteração específica de layout de toque, o jogo deverá usar XGameStreamingUpdateTouchControlsState.

Exemplos

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

XGameStreaming
XGameStreamingTouchControlsStateOperationKind
XGameStreamingTouchControlsStateOperation
XGameStreamingTouchControlsStateValue
XGameStreamingShowTouchControlsWithStateUpdateOnClient
XGameStreamingUpdateTouchControlsState
XGameStreamingUpdateTouchControlsStateOnClient
Last modified on October 6, 2026