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 |