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

# XGameStreamingGamepadPhysicality

> XGameStreamingGamepadPhysicality

# XGameStreamingGamepadPhysicality

Mapeamento de fisicalidade para cada botão, direcional analógico e gatilho em um Controle Sem Fio XBOX padrão. Para qualquer botão/direcional analógico/gatilho, a fisicalidade pode ser desconhecida, física, virtual ou ambas.

## Sintaxe

```cpp theme={null}
enum class XGameStreamingGamepadPhysicality  : uint64_t  
{  
    None = 0x0000000000000000,  
    DPadUpPhysical = 0x0000000000000001,  
    DPadDownPhysical = 0x0000000000000002,  
    DPadLeftPhysical = 0x0000000000000004,  
    DPadRightPhysical = 0x0000000000000008,  
    MenuPhysical = 0x0000000000000010,  
    ViewPhysical = 0x0000000000000020,  
    LeftThumbstickPhysical = 0x0000000000000040,  
    RightThumbstickPhysical = 0x0000000000000080,  
    LeftShoulderPhysical = 0x0000000000000100,  
    RightShoulderPhysical = 0x0000000000000200,  
    APhysical = 0x0000000000001000,  
    BPhysical = 0x0000000000002000,  
    XPhysical = 0x0000000000004000,  
    YPhysical = 0x0000000000008000,  
    LeftTriggerPhysical = 0x0000000000010000,  
    RightTriggerPhysical = 0x0000000000020000,  
    LeftThumbstickXPhysical = 0x0000000000040000,  
    LeftThumbstickYPhysical = 0x0000000000080000,  
    RightThumbstickXPhysical = 0x0000000000100000,  
    RightThumbstickYPhysical = 0x0000000000200000,  
    ButtonsPhysical = 0x000000000000F3FF,  
    AnalogsPhysical = 0x00000000003F0000,  
    AllPhysical = 0x00000000003FF3FF,  
    DPadUpVirtual = 0x0000000100000000,  
    DPadDownVirtual = 0x0000000200000000,  
    DPadLeftVirtual = 0x0000000400000000,  
    DPadRightVirtual = 0x0000000800000000,  
    MenuVirtual = 0x0000001000000000,  
    ViewVirtual = 0x0000002000000000,  
    LeftThumbstickVirtual = 0x0000004000000000,  
    RightThumbstickVirtual = 0x0000008000000000,  
    LeftShoulderVirtual = 0x0000010000000000,  
    RightShoulderVirtual = 0x0000020000000000,  
    AVirtual = 0x0000100000000000,  
    BVirtual = 0x0000200000000000,  
    XVirtual = 0x0000400000000000,  
    YVirtual = 0x0000800000000000,  
    LeftTriggerVirtual = 0x0001000000000000,  
    RightTriggerVirtual = 0x0002000000000000,  
    LeftThumbstickXVirtual = 0x0004000000000000,  
    LeftThumbstickYVirtual = 0x0008000000000000,  
    RightThumbstickXVirtual = 0x0010000000000000,  
    RightThumbstickYVirtual = 0x0020000000000000,  
    ButtonsVirtual = 0x0000F3FF00000000,  
    AnalogsVirtual = 0x003F000000000000,  
    AllVirtual = 0x003FF3FF00000000,  
}  
```

## Constantes

| Constante | Descrição |
| - | - |
| None | Nenhum botão do gamepad |
| DPadUpPhysical | Botão para cima do direcional do gamepad físico |
| DPadDownPhysical | Botão para baixo do direcional do gamepad físico |
| DPadLeftPhysical | Botão para a esquerda do direcional do gamepad físico |
| DPadRightPhysical | Botão para a direita do direcional do gamepad físico |
| MenuPhysical | Botão Menu do gamepad físico |
| ViewPhysical | Botão Exibir do gamepad físico |
| LeftThumbstickPhysical | Botão de pressionar o direcional analógico esquerdo do gamepad físico |
| RightThumbstickPhysical | Botão de pressionar o direcional analógico direito do gamepad físico |
| LeftShoulderPhysical | Botão de ombro esquerdo do gamepad físico |
| RightShoulderPhysical | Botão de ombro direito do gamepad físico |
| APhysical | Botão A do gamepad físico |
| BPhysical | Botão B do gamepad físico |
| XPhysical | Botão X do gamepad físico |
| YPhysical | Botão Y do gamepad físico |
| LeftTriggerPhysical | Gatilho esquerdo do gamepad físico |
| RightTriggerPhysical | Gatilho direito do gamepad físico |
| LeftThumbstickXPhysical | Posição horizontal do direcional analógico esquerdo do gamepad físico |
| LeftThumbstickYPhysical | Posição vertical do direcional analógico esquerdo do gamepad físico |
| RightThumbstickXPhysical | Posição horizontal do direcional analógico direito do gamepad físico |
| RightThumbstickYPhysical | Posição vertical do direcional analógico direito do gamepad físico |
| ButtonsPhysical | Todos os botões são físicos |
| AnalogsPhysical | Todas as entradas analógicas são físicas |
| AllPhysical | Todas as entradas são físicas |
| DPadUpVirtual | Botão para cima do direcional do gamepad virtual |
| DPadDownVirtual | Botão para baixo do direcional do gamepad virtual |
| DPadLeftVirtual | Botão para a esquerda do direcional do gamepad virtual |
| DPadRightVirtual | Botão para a direita do direcional do gamepad virtual |
| MenuVirtual | Botão Menu do gamepad virtual |
| ViewVirtual | Botão Exibir do gamepad virtual |
| LeftThumbstickVirtual | Botão de pressionar o direcional analógico esquerdo do gamepad virtual |
| RightThumbstickVirtual | Botão de pressionar o direcional analógico direito do gamepad virtual |
| LeftShoulderVirtual | Botão de ombro esquerdo do gamepad virtual |
| RightShoulderVirtual | Botão de ombro direito do gamepad virtual |
| AVirtual | Botão A do gamepad virtual |
| BVirtual | Botão B do gamepad virtual |
| XVirtual | Botão X do gamepad virtual |
| YVirtual | Botão Y do gamepad virtual |
| LeftTriggerVirtual | Gatilho esquerdo do gamepad virtual |
| RightTriggerVirtual | Gatilho direito do gamepad virtual |
| LeftThumbstickXVirtual | Posição horizontal do direcional analógico esquerdo do gamepad virtual |
| LeftThumbstickYVirtual | Posição vertical do direcional analógico esquerdo do gamepad virtual |
| RightThumbstickXVirtual | Posição horizontal do direcional analógico direito do gamepad virtual |
| RightThumbstickYVirtual | Posição vertical do direcional analógico direito do gamepad virtual |
| ButtonsVirtual | Todos os botões são virtuais |
| AnalogsVirtual | Todas as entradas analógicas são virtuais |
| AllVirtual | Todas as entradas são virtuais |

## Comentários

Os jogos podem usar [XGameStreamingGamepadPhysicality](/pt-BR/reference/system/xgamestreaming/enums/xgamestreaminggamepadphysicality) para entender se o `IGameInputReading` inclui entrada de um controle físico, de um controle virtual por toque ou de ambos.

No momento, há suporte apenas para leituras de gamepad.

Os sinalizadores podem ser combinados para representar vários valores.

Os valores `AllPhysical` ou `AllVirtual` podem ser usados para identificar se todas as entradas são de um tipo específico, para tomar decisões de jogabilidade, como quais dicas visuais fornecer ao jogador.

## Requisitos

**Cabeçalho:** xgamestreaming.h

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

## Confira também

[XGameStreamingGetGamepadPhysicality](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetgamepadphysicality)\
[XGameStreaming](/pt-BR/reference/system/xgamestreaming/xgamestreaming_members)


## Related topics

- [XGameStreamingGetGamepadPhysicality](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetgamepadphysicality.md)
- [XGameStreaming](/pt-BR/reference/system/xgamestreaming/xgamestreaming_members.md)
- [Guia do designer para criar controles por toque](/pt-BR/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-designers-guide.md)
- [XGameStreamingGetAssociatedFrame](/pt-BR/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe.md)
- [GAMEPAD_VIBRATION](/pt-BR/reference/tools/xtf/xtfinput/structures/gamepad_vibration.md)