Skip to main content

XGameStreamingGetGamepadPhysicality

Obtém o mapeamento de fisicalidade de entrada de uma leitura específica do gamepad.

Sintaxe

Parâmetros

gamepadReading   _In_
Tipo: IGameInputReading*
A leitura do gamepad que está sendo consultada. gamepadPhysicality   _Out_
Tipo: XGameStreamingGamepadPhysicality*
A fisicalidade da leitura de entrada.

Valor retornado

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

Comentários

Os jogos talvez precisem diferenciar uma entrada de controle com base em se ela veio de um controle conectado fisicamente ou de um layout de toque que foi convertido em uma entrada de controle virtual. Cenário de exemplo O jogo tem uma ação de pular associada ao botão A. Ele oferece um layout de toque com o ícone de pular configurado com o pressionamento do botão A no controle virtual. O jogo também oferece aos jogadores a capacidade de remapear o controle físico de forma que A não esteja mais associado a pular. O jogo pode apresentar dicas visuais para interagir com elementos do jogo (por exemplo, Pressione A para pular). Quando o jogador usa os layouts de toque, a dica visual deve mostrar a iconografia do botão do layout de toque.

Exemplo

No exemplo de código a seguir, o jogo tem a ação de pular vinculada ao botão A do controle por padrão. Embora essa configuração possa ser personalizada pelo jogador, o layout de toque na tela é fixo e, portanto, um pressionamento do botão A no layout de toque deve sempre ser tratado como pular, enquanto o A de um controle físico deve ser tratado de acordo com o que o jogador definiu na personalização do mapeamento do controle.

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
XGameStreamingGamepadPhysicality
Adaptação de toque do XGameStreaming
Last modified on October 6, 2026