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

# XInputOnGameInput

> XInputOnGameInput

# XInputOnGameInput

Microsoft GDK(게임 개발 키트)에는 GameInput 위에 XInput API의 구현이 포함된 헤더 파일 XInputOnGameInput.h가 제공됩니다. 특히 키보드와 마우스 또는 기타 입력 장치가 필요한 경우 GameInput으로 직접 이식하는 것이 좋습니다. 그러나 XInputOnGameInput 래퍼를 사용하여 기존 XInput 코드를 변경하지 않고 초기 이식 작업을 부트스트랩하는 데 도움을 받을 수 있습니다.

## 함수

| 함수                                                                                                          | 설명                                                  |
| ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| [XInputEnable](/reference/input/xinputongameinput/functions/xinputenable)                                   | XInputEnable API 참조                                 |
| [XInputGetAudioDeviceIds](/reference/input/xinputongameinput/functions/xinputgetaudiodeviceids)             | 지정된 컨트롤러에 연결된 헤드셋의 오디오 렌더링 및 캡처 장치의 ID를 검색합니다.      |
| [XInputGetBatteryInformation](/reference/input/xinputongameinput/functions/xinputgetbatteryinformation)     | 무선 컨트롤러의 배터리 유형과 충전 상태를 검색합니다.                      |
| [XInputGetCapabilities](/reference/input/xinputongameinput/functions/xinputgetcapabilities)                 | 연결된 컨트롤러의 기능과 특성을 검색합니다.                            |
| [XInputGetDeviceId](/reference/input/xinputongameinput/functions/xinputgetdeviceid)                         | 지정된 컨트롤러의 장치 ID를 검색합니다.                             |
| [XInputGetKeystroke](/reference/input/xinputongameinput/functions/xinputgetkeystroke)                       | XInputGetKeystroke API 참조                           |
| [XInputGetState](/reference/input/xinputongameinput/functions/xinputgetstate)                               | 지정된 컨트롤러의 현재 상태를 검색합니다.                             |
| [XInputGetStateWithToken](/reference/input/xinputongameinput/functions/xinputgetstatewithtoken)             | 지정된 컨트롤러의 현재 상태를 검색하고 D3DX 프레임 파이프라인 토큰과 연결합니다.     |
| [XInputOnGameInputInitialize](/reference/input/xinputongameinput/functions/xinputongameinputinitialize)     | XInputOnGameInputInitialize API 참조                  |
| [XInputOnGameInputUninitialize](/reference/input/xinputongameinput/functions/xinputongameinputuninitialize) | XInputOnGameInputUninitialize API 참조                |
| [XInputSetState](/reference/input/xinputongameinput/functions/xinputsetstate)                               | 지정된 2모터 컨트롤러에 진동 데이터를 전송합니다.                        |
| [XInputSetStateEx](/reference/input/xinputongameinput/functions/xinputsetstateex)                           | 지정된 컨트롤러에 진동 데이터를 전송합니다. 최신 컨트롤러의 4모터 진동 기능을 지원합니다. |

## 구조체

| 구조체                                                                                                   | 설명                                           |
| ----------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| [XINPUT\_BATTERY\_INFORMATION](/reference/input/xinputongameinput/structs/xinput_battery_information) | 배터리의 유형과 충전 상태를 설명합니다.                       |
| [XINPUT\_CAPABILITIES](/reference/input/xinputongameinput/structs/xinput_capabilities)                | XINPUT\_CAPABILITIES API 참조                  |
| [XINPUT\_GAMEPAD](/reference/input/xinputongameinput/structs/xinput_gamepad)                          | XINPUT\_GAMEPAD API 참조                       |
| [XINPUT\_KEYSTROKE](/reference/input/xinputongameinput/structs/xinput_keystroke)                      | XInputGetKeystroke 함수가 반환하는 키 입력 데이터를 설명합니다. |
| [XINPUT\_STATE](/reference/input/xinputongameinput/structs/xinput_state)                              | 컨트롤러의 상태를 설명합니다.                             |
| [XINPUT\_VIBRATION](/reference/input/xinputongameinput/structs/xinput_vibration)                      | 2모터 컨트롤러의 진동 기능에 대한 모터 속도를 설명합니다.            |
| [XINPUT\_VIBRATION\_EX](/reference/input/xinputongameinput/structs/xinput_vibration_ex)               | 4모터 컨트롤러의 진동 기능에 대한 모터 속도를 설명합니다.            |

## 개념 문서

* [XInput에서 GameInput으로 이식](/build/core-features/common/input/porting/input-porting-xinput)

## 참고 항목

[Input API 참조](/reference/input/gc-reference-input-toc)


## Related topics

- [XInputOnGameInputInitialize](/ko/reference/input/xinputongameinput/functions/xinputongameinputinitialize.md)
- [XInputOnGameInputUninitialize](/ko/reference/input/xinputongameinput/functions/xinputongameinputuninitialize.md)
- [XInputEnable](/ko/reference/input/xinputongameinput/functions/xinputenable.md)
- [Input API reference](/ko/reference/input/gc-reference-input-toc.md)
- [XInput에서 GameInput으로 포팅](/ko/build/core-features/common/input/porting/input-porting-xinput.md)