> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputControllerSwitchInfo

> GameInputControllerSwitchInfo

# GameInputControllerSwitchInfo

입력 장치의 스위치를 설명합니다.

## 구문

```cpp theme={null}
struct GameInputControllerSwitchInfo
{
    GameInputLabel      labels[GAMEINPUT_MAX_SWITCH_STATES];
    GameInputSwitchKind kind;
};
```

### 멤버

*labels*\

형식: [GameInputLabel](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputlabel.md)

스위치 상태의 레이블입니다.

*kind*\

형식: [GameInputSwitchKind](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputswitchkind.md)

스위치의 유형입니다.

## 설명

이 구조체는 [GameInputControllerInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputcontrollerinfo.md) 구조체에서 사용됩니다. `GameInputControllerInfo`는 [GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputdeviceinfo.md) 구조체에서 컨트롤러 입력 장치의 속성을 설명하기 위해 사용됩니다.

## 요구 사항

**헤더:** GameInput.h

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/ko/reference/input/gameinput/gameinput_members.md)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v3** | `mappedInputKinds` **제거됨**. 단일 `label`을 배열 `labels[GAMEINPUT_MAX_SWITCH_STATES]`로 대체함. |
| **v1** | `positionLabels[9]`, 모든 레거시/원시 HID 및 DInput 필드(`legacyDInputIndex`, `legacyHidIndex`, `rawReportIndex`, 원시 보고서 포인터) **제거됨**. |
| **v0** | 도입됨. |

## 부록: 이전 버전

### v1, v2

```cpp theme={null}
struct GameInputControllerSwitchInfo
{
    GameInputKind       mappedInputKinds;
    GameInputLabel      label;
    GameInputSwitchKind kind;
};
```

### v0

```cpp theme={null}
struct GameInputControllerSwitchInfo
{
    GameInputKind       mappedInputKinds;
    GameInputLabel      label;
    GameInputLabel      positionLabels[9];
    GameInputSwitchKind kind;
    uint8_t             legacyDInputIndex;
    uint8_t             legacyHidIndex;
    uint16_t            rawReportIndex;
};
```


## Related topics

- [GameInputControllerInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputcontrollerinfo.md)
- [GameInputSwitchKind](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputswitchkind.md)
- [GameInputLabel](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputlabel.md)
- [GameInput API 멤버](https://docs.xbox.com/ko/reference/input/gameinput/gameinput_members.md)
- [GetControllerSwitchCount](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchcount.md)