XInputGetState
지정된 컨트롤러의 현재 상태를 검색합니다.
구문
DWORD XInputGetState(
DWORD dwUserIndex,
XINPUT_STATE * pState
)
매개 변수
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 함수는 비슷하지만 호출자가 D3DX 프레임 파이프라인 토큰을 공급하여 PIX에서 나중에 분석을 위해 특정 입력 읽기를 그래픽 프레임과 연결하도록 허용합니다.
자세한 내용은 XInputOnGameInput 래퍼를 참조하세요.
요구 사항
헤더: XInputOnGameInput.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Xbox One 패밀리 콘솔 및 Xbox Series 콘솔