XInputGetState 함수(xinput.h)

아티클
03/05/2024

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

구문

DWORD XInputGetState(
  [in]  DWORD        dwUserIndex,
  [out] XINPUT_STATE *pState
);

매개 변수

[in] dwUserIndex

사용자 컨트롤러의 인덱스입니다. 0에서 3까지의 값일 수 있습니다. 이 값을 결정하는 방법과 값이 컨트롤러의 지표에 매핑되는 방법에 대한 자세한 내용은 여러 컨트롤러를 참조하세요.

[out] pState

컨트롤러의 현재 상태를 수신하는 XINPUT_STATE 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

컨트롤러가 연결되어 있지 않으면 반환 값이 ERROR_DEVICE_NOT_CONNECTED.

함수가 실패하면 반환 값은 Winerror.h에 정의된 오류 코드입니다. 함수는 SetLastError 를 사용하여 호출 스레드의 마지막 오류 코드를 설정하지 않습니다.

설명

XInputGetState를 사용하여 컨트롤러 데이터를 검색하는 경우 왼쪽 및 오른쪽 트리거는 각각 별도로 보고됩니다. 레거시 이유로 DirectInput이 컨트롤러 데이터를 검색할 때 두 트리거는 동일한 축을 공유합니다. 레거시 동작은 컨트롤러 상태에 DirectInput을 사용하는 현재 게임 장치 제어판 눈에 띄습니다.