XInputGetKeystroke 함수(xinput.h)

게임 패드 입력 이벤트를 검색합니다.

구문

DWORD XInputGetKeystroke(
  DWORD             dwUserIndex,
  DWORD             dwReserved,
  PXINPUT_KEYSTROKE pKeystroke
);

매개 변수

dwUserIndex

[in] 디바이스와 연결된 로그인된 게이머의 인덱스입니다. 0-XUSER_MAX_COUNT - 1 범위의 값이거나 모든 사용자로부터 사용 가능한 다음 입력 이벤트를 가져오는 XUSER_INDEX_ANY 수 있습니다.

dwReserved

[in] 예약

pKeystroke

[out] 입력 이벤트를 수신하는 XINPUT_KEYSTROKE 구조체에 대한 포인터입니다.

반환 값

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

새 키를 누르지 않은 경우 반환 값이 ERROR_EMPTY.

컨트롤러가 연결되지 않았거나 사용자가 컨트롤러를 활성화하지 않은 경우 반환 값이 ERROR_DEVICE_NOT_CONNECTED. 아래의 설명 섹션을 참조하세요.

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

설명

무선 컨트롤러는 시스템 시작 시 활성으로 간주되지 않으며 무선 컨트롤러가 ERROR_DEVICE_NOT_CONNECTED 활성 반환되기 전에 XInput 함수를 호출합니다. 게임 타이틀은 반환 코드를 검사하고 이 조건을 처리할 준비를 해야 합니다. 유선 컨트롤러는 삽입될 때 자동으로 활성화됩니다. 무선 컨트롤러는 사용자가 컨트롤러에서 전원을 켜면 활성화됩니다.

플랫폼 요구 사항

Windows 8(XInput 1.4), DirectX SDK(XInput 1.3)

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	xinput.h
라이브러리	Xinput.lib
DLL	Xinput1_4.dll

추가 정보

XINPUT_KEYSTROKE

XInput 함수