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

# GameInputControllerInfo

> GameInputControllerInfo

# GameInputControllerInfo

컨트롤러의 속성을 설명합니다.

## 구문

```cpp theme={null}
struct GameInputControllerInfo
{
    uint32_t                             controllerAxisCount;
    const GameInputLabel*                controllerAxisLabels;
    uint32_t                             controllerButtonCount;
    const GameInputLabel*                controllerButtonLabels;
    uint32_t                             controllerSwitchCount;
    const GameInputControllerSwitchInfo* controllerSwitchInfo;
};
```

### 멤버

*controllerAxisCount*<br />
형식: uint32\_t

컨트롤러의 축 개수입니다.

*controllerAxisLabels*<br />
형식: [GameInputLabel](/ko/reference/input/gameinput/enums/gameinputlabel) const \*

컨트롤러의 축 레이블입니다.

*controllerButtonCount*<br />
형식: uint32\_t

컨트롤러의 버튼 개수입니다.

*controllerButtonLabels*<br />
형식: [GameInputLabel](/ko/reference/input/gameinput/enums/gameinputlabel) const \*

컨트롤러의 버튼 레이블입니다.

*controllerSwitchCount*<br />
형식: uint32\_t

컨트롤러의 스위치 개수입니다.

*controllerSwitchInfo*<br />
형식: [GameInputControllerSwitchInfo](/ko/reference/input/gameinput/structs/gameinputcontrollerswitchinfo) const \*

컨트롤러의 스위치에 대한 정보입니다.

## 설명

`GameInputControllerInfo` 구조체의 필드는 컨트롤러에 대한 정보의 가변 크기 배열에 대한 포인터입니다. NULL 포인터는 해당 기능이 컨트롤러에서 사용할 수 없거나 지원되지 않음을 나타냅니다. 각 배열의 요소 수는 구조체의 해당 필드로 표시됩니다(SAL 주석에 명시됨).

이 구조체는 [GameInputDeviceInfo](/ko/reference/input/gameinput/structs/gameinputdeviceinfo) 구조체에서 사용됩니다. `GameInputDeviceInfo`는 [IGameInputDevice::GetDeviceInfo](/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo) 메서드에서 사용됩니다.

자세한 내용은 [GameInput 장치](/ko/build/core-features/common/input/overviews/input-devices)를 참조하세요.

## 요구 사항

**헤더:** GameInput.h

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

## 함께 보기

[GameInput 개요](/ko/build/core-features/common/input/overviews/input-overview)<br />

[GameInput](/ko/reference/input/gameinput/gameinput_members)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v3** | 현재 API에 **새로 도입된 구조체**. v0, v1 및 v2에 존재했던 별도의 `GameInputControllerAxisInfo` 및 `GameInputControllerButtonInfo` 구조체를 대체합니다. |


## Related topics

- [GameInputControllerSwitchInfo](/ko/reference/input/gameinput/structs/gameinputcontrollerswitchinfo.md)
- [GameInputControllerButtonInfo](/ko/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [GameInputControllerAxisInfo](/ko/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)
- [GameInput](/ko/reference/input/gameinput/gameinput_members.md)
- [GameInputLabel](/ko/reference/input/gameinput/enums/gameinputlabel.md)