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

표준 XBOX 무선 컨트롤러의 모든 단추, 스틱, 트리거에 대한 물리성 매핑입니다. 지정된 모든 단추/스틱/트리거에 대해 물리성은 알 수 없음, 물리적, 가상 또는 두 가지 모두가 될 수 있습니다.

## 구문

```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,  
}  
```

## 상수

| 상수                       | 설명                       |
| ------------------------ | ------------------------ |
| None                     | 게임패드 단추 없음               |
| DPadUpPhysical           | 물리적 게임패드 방향 패드 위 단추      |
| DPadDownPhysical         | 물리적 게임패드 방향 패드 아래 단추     |
| DPadLeftPhysical         | 물리적 게임패드 방향 패드 왼쪽 단추     |
| DPadRightPhysical        | 물리적 게임패드 방향 패드 오른쪽 단추    |
| MenuPhysical             | 물리적 게임패드 메뉴 단추           |
| ViewPhysical             | 물리적 게임패드 보기 단추           |
| LeftThumbstickPhysical   | 물리적 게임패드 왼쪽 엄지 스틱 누름 단추  |
| RightThumbstickPhysical  | 물리적 게임패드 오른쪽 엄지 스틱 누름 단추 |
| LeftShoulderPhysical     | 물리적 게임패드 왼쪽 어깨 단추        |
| RightShoulderPhysical    | 물리적 게임패드 오른쪽 어깨 단추       |
| APhysical                | 물리적 게임패드 A 단추            |
| BPhysical                | 물리적 게임패드 B 단추            |
| XPhysical                | 물리적 게임패드 X 단추            |
| YPhysical                | 물리적 게임패드 Y 단추            |
| LeftTriggerPhysical      | 물리적 게임패드 왼쪽 트리거          |
| RightTriggerPhysical     | 물리적 게임패드 오른쪽 트리거         |
| LeftThumbstickXPhysical  | 물리적 게임패드 왼쪽 엄지 스틱 수평 위치  |
| LeftThumbstickYPhysical  | 물리적 게임패드 왼쪽 엄지 스틱 수직 위치  |
| RightThumbstickXPhysical | 물리적 게임패드 오른쪽 엄지 스틱 수평 위치 |
| RightThumbstickYPhysical | 물리적 게임패드 오른쪽 엄지 스틱 수직 위치 |
| ButtonsPhysical          | 모든 단추가 물리적임              |
| AnalogsPhysical          | 모든 아날로그 입력이 물리적임         |
| AllPhysical              | 모든 입력이 물리적임              |
| DPadUpVirtual            | 가상 게임패드 방향 패드 위 단추       |
| DPadDownVirtual          | 가상 게임패드 방향 패드 아래 단추      |
| DPadLeftVirtual          | 가상 게임패드 방향 패드 왼쪽 단추      |
| DPadRightVirtual         | 가상 게임패드 방향 패드 오른쪽 단추     |
| MenuVirtual              | 가상 게임패드 메뉴 단추            |
| ViewVirtual              | 가상 게임패드 보기 단추            |
| LeftThumbstickVirtual    | 가상 게임패드 왼쪽 엄지 스틱 누름 단추   |
| RightThumbstickVirtual   | 가상 게임패드 오른쪽 엄지 스틱 누름 단추  |
| LeftShoulderVirtual      | 가상 게임패드 왼쪽 어깨 단추         |
| RightShoulderVirtual     | 가상 게임패드 오른쪽 어깨 단추        |
| AVirtual                 | 가상 게임패드 A 단추             |
| BVirtual                 | 가상 게임패드 B 단추             |
| XVirtual                 | 가상 게임패드 X 단추             |
| YVirtual                 | 가상 게임패드 Y 단추             |
| LeftTriggerVirtual       | 가상 게임패드 왼쪽 트리거           |
| RightTriggerVirtual      | 가상 게임패드 오른쪽 트리거          |
| LeftThumbstickXVirtual   | 가상 게임패드 왼쪽 엄지 스틱 수평 위치   |
| LeftThumbstickYVirtual   | 가상 게임패드 왼쪽 엄지 스틱 수직 위치   |
| RightThumbstickXVirtual  | 가상 게임패드 오른쪽 엄지 스틱 수평 위치  |
| RightThumbstickYVirtual  | 가상 게임패드 오른쪽 엄지 스틱 수직 위치  |
| ButtonsVirtual           | 모든 단추가 가상임               |
| AnalogsVirtual           | 모든 아날로그 입력이 가상임          |
| AllVirtual               | 모든 입력이 가상임               |

## 설명

게임은 [XGameStreamingGamepadPhysicality](/reference/system/xgamestreaming/enums/xgamestreaminggamepadphysicality)를 사용하여 `IGameInputReading`이 물리적 컨트롤러, 가상 터치 컨트롤러 또는 두 가지 모두의 입력을 포함하는지 이해할 수 있습니다.

현재 게임패드 판독값에 대해서만 지원됩니다.

플래그는 여러 값을 나타내기 위해 결합할 수 있습니다.

`AllPhysical` 또는 `AllVirtual` 값은 모든 입력이 특정 유형인지 식별하는 데 사용될 수 있으며, 플레이어에게 제공할 시각적 힌트와 같은 게임 플레이 결정을 내리는 데 사용할 수 있습니다.

## 요구 사항

**헤더:** xgamestreaming.h

**지원되는 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 함께 보기

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


## Related topics

- [XGameStreamingGetGamepadPhysicality](/ko/reference/system/xgamestreaming/functions/xgamestreaminggetgamepadphysicality.md)
- [XGameStreaming](/ko/reference/system/xgamestreaming/xgamestreaming_members.md)
- [GAMEPAD_VIBRATION](/ko/reference/tools/xtf/xtfinput/structures/gamepad_vibration.md)
- [XINPUT_GAMEPAD](/ko/reference/input/xinputongameinput/structs/xinput_gamepad.md)
- [XGameStreamingGetAssociatedFrame](/ko/reference/system/xgamestreaming/functions/xgamestreaminggetassociatedframe.md)
