Skip to main content

XInputEnable

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

구문

매개변수

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

반환값

형식: void 없음.

설명

이 함수는 사용되지 않으며 새 코드에 작성되어서는 안 됩니다. XInputEnable은 많은 XInput 래퍼 호출에 오버헤드를 추가합니다. #define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE을 사용하면 XInputEnable과 그로 인해 발생하는 오버헤드를 제거할 수 있습니다. 자세한 내용은 XInput에서 GameInput으로 이식을 참조하세요. 이 함수는 애플리케이션이 포커스를 얻거나 잃을 때 호출되기 위한 것입니다. 이 함수를 사용할 때 XInput이 비활성화되면 항상 중립 데이터가 보고되므로 애플리케이션의 XInput 쿼리 루프를 변경할 필요가 없습니다. 진동 효과를 지원하는 컨트롤러의 경우:
  • FALSE를 전달하면 현재 재생 중인 모든 진동 효과가 중지됩니다. 이 상태에서 XInputSetState 호출은 등록되지만 장치로 전달되지 않습니다.
  • TRUE를 전달하면 XInputSetState에 전송된 마지막 진동 요청(0이더라도)이 장치로 전달됩니다.

요구 사항

헤더: XInputOnGameInput.h 라이브러리: xgameruntime.lib 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

참고 항목

XInput을 GameInput으로 이식
XInputOnGameInput
XInputGetState
XInputSetState
마지막 수정일 2026년 8월 24일