XInputEnable 함수(xinput.h)

아티클
03/09/2024

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

구문

void XInputEnable(
  [in] BOOL enable
);

매개 변수

[in] enable

enable이 FALSE인 경우 XInput은 XInputGetState 에 대한 응답으로 중립 데이터만 보냅니다(모든 단추 위로, 축 중심 및 트리거는 0). XInputSetState 호출은 등록되지만 디바이스로 전송되지 않습니다. FALSE 이외의 값을 보내면 읽기 및 쓰기 기능이 정상으로 복원됩니다.

반환 값

없음

설명

이 함수는 애플리케이션이 포커스를 얻거나 잃을 때(예: WM_ACTIVATEAPP 통해) 호출됩니다. 이 함수를 사용하면 XInput이 사용하지 않도록 설정된 경우 중립 데이터가 항상 보고되므로 애플리케이션에서 XInput 쿼리 루프를 변경할 필요가 없습니다.

진동 효과를 지원하는 컨트롤러에서 다음을 수행합니다.

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

Windows 10 이상: 애플리케이션 창 포커스에 따라 시스템에서 게임 컨트롤러 입력을 자동으로 사용하거나 사용하지 않도록 설정하므로 사용되지 않습니다.