XInputEnable

XInput의 보고 상태를 설정합니다.

구문

void XInputEnable(  
         BOOL enable  
)  

매개 변수

enable _In_
형식: BOOL

enable이 FALSE인 경우 XInput은 XInputGetState에 대한 응답으로 중립 데이터만 전송합니다. 즉, 모든 버튼을 위로, 축을 중심으로 하고, 트리거를 0으로. XInputSetState 호출이 등록되지만 장치로 전송되지는 않습니다. FALSE 이외의 값을 보내면 읽기 및 쓰기 기능이 정상으로 복원됩니다.

반환 값

형식: void

없음.

설명

이 함수는 더 이상 사용되지 않으며, 새 코드에 작성해서는 안됩니다. XInputEnable은 많은 XInput 래퍼 호출에 오버헤드를 추가합니다. XInputEnable 및 결과 오버헤드를 제거하기 위해 #define XINPUT_ON_GAMEINPUT_NO_XINPUTENABLE할 수 있습니다. 자세한 내용은 XInput에서 GameInput으로 포팅을 참조하세요.

이 함수는 응용 프로그램이 포커스를 얻거나 잃을 때 호출됩니다. 이 함수를 사용하면 XInput이 비활성화된 경우 중립 데이터가 항상 보고되므로 애플리케이션에서 XInput 쿼리 루프를 변경할 필요가 없습니다.

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

• FALSE를 전달하면 현재 재생 중인 진동 효과가 중지됩니다. 이 상태에서는 XInputSetState에 대한 호출이 등록되지만 장치에는 전달되지 않습니다.
• TRUE를 전달하면 XInputSetState로 전송된 마지막 진동 요청(0인 경우를 포함)이 장치에 전달됩니다.

요구 사항

헤더: XInputOnGameInput.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XInput에서 GameInput으로 포트
XInputOnGameInput
XInputGetState
XInputSetState