Skip to main content

XInputGetState

지정된 컨트롤러의 현재 상태를 검색합니다.

구문

매개변수

dwUserIndex   _In_
형식: DWORD
장치와 연결된 게이머의 인덱스입니다. 값은 0에서 XUSER_MAX_COUNT - 1 범위입니다. pState   _Out_
형식: XINPUT_STATE*
컨트롤러의 현재 상태를 받는 XINPUT_STATE 객체에 대한 포인터입니다.

반환값

형식: DWORD 함수가 성공하면 ERROR_SUCCESS를 반환합니다. 컨트롤러가 연결되어 있지 않으면 함수는 ERROR_DEVICE_NOT_CONNECTED를 반환합니다. 함수가 실패하면 WinError.h에 정의된 오류 코드를 반환합니다.

설명

이 함수는 왼쪽 트리거와 오른쪽 트리거를 별도로 보고합니다. DirectInput에서는 두 트리거가 동일한 축을 공유했습니다. XInputGetStateWithToken 함수는 유사하지만, 나중에 PIX에서 분석할 수 있도록 특정 입력 리딩을 그래픽 프레임과 연결할 수 있도록 호출자가 D3DX 프레임 파이프라인 토큰을 제공하도록 허용합니다. 자세한 내용은 XInputOnGameInput 래퍼를 참조하세요.

요구 사항

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

참고 항목

XInput에서 GameInput으로 이식
XInputOnGameInput
마지막 수정일 2026년 8월 24일