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

# XInputEnable

> XInputEnable

# XInputEnable

XInput의 리포팅 상태를 설정합니다.

## 구문

```cpp theme={null}
void XInputEnable(  
         BOOL enable  
)  
```

### 매개변수

*enable*   \_In\_\
형식: BOOL

enable이 **FALSE**이면 XInput은 [XInputGetState](/reference/input/xinputongameinput/functions/xinputgetstate)에 대한 응답으로 중립 데이터만 보냅니다. 즉, 모든 버튼은 눌리지 않은 상태이고, 축은 중앙에 있으며 트리거는 0입니다. [XInputSetState](/reference/input/xinputongameinput/functions/xinputsetstate) 호출은 등록되지만 장치에 전송되지 않습니다. **FALSE** 이외의 값을 보내면 읽기 및 쓰기 기능이 정상으로 복원됩니다.

### 반환값

형식: void

없음.

## 설명

이 함수는 사용되지 않으며 새 코드에 작성되어서는 안 됩니다. XInputEnable은 많은 XInput 래퍼 호출에 오버헤드를 추가합니다. `#define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE`을 사용하면 XInputEnable과 그로 인해 발생하는 오버헤드를 제거할 수 있습니다. 자세한 내용은 [XInput에서 GameInput으로 이식](/build/core-features/common/input/porting/input-porting-xinput#optimizingSection)을 참조하세요.

이 함수는 애플리케이션이 포커스를 얻거나 잃을 때 호출되기 위한 것입니다. 이 함수를 사용할 때 XInput이 비활성화되면 항상 중립 데이터가 보고되므로 애플리케이션의 XInput 쿼리 루프를 변경할 필요가 없습니다.

진동 효과를 지원하는 컨트롤러의 경우:

* **FALSE**를 전달하면 현재 재생 중인 모든 진동 효과가 중지됩니다. 이 상태에서 [XInputSetState](/reference/input/xinputongameinput/functions/xinputsetstate) 호출은 등록되지만 장치로 전달되지 않습니다.
* **TRUE**를 전달하면 [XInputSetState](/reference/input/xinputongameinput/functions/xinputsetstate)에 전송된 마지막 진동 요청(0이더라도)이 장치로 전달됩니다.

## 요구 사항

**헤더:** XInputOnGameInput.h

**라이브러리:** xgameruntime.lib

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

## 참고 항목

[XInput을 GameInput으로 이식](/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members)\
[XInputGetState](/reference/input/xinputongameinput/functions/xinputgetstate)\
[XInputSetState](/reference/input/xinputongameinput/functions/xinputsetstate)


## Related topics

- [XInputOnGameInput](/ko/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XInput에서 GameInput으로 포팅](/ko/build/core-features/common/input/porting/input-porting-xinput.md)
- [IGameInput::EnableOemDeviceSupport](/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_enableoemdevicesupport.md)
- [XGameStreamingIsTouchInputEnabled](/ko/reference/system/xgamestreaming/functions/xgamestreamingistouchinputenabled.md)
- [사용되지 않는 GameInput API 멤버](/ko/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)