XInputGetKeystroke
게임 패드 입력 이벤트를 검색합니다.
구문
DWORD XInputGetKeystroke(
DWORD dwUserIndex,
_Reserved_ dwReserved,
XINPUT_KEYSTROKE* pKeystroke
)
매개 변수
dwUserIndex _In_
형식: DWORD
장치와 연결된 로그인되어 있는 게이머의 색인입니다. 0–XUSER_MAX_COUNT ~ 1 범위의 값인 XUSER_INDEX_ANY는 모든 사용자로부터 사용 가능한 다음 입력 이벤트를 가져오는 데 사용됩니다.
dwReserved
형식: Reserved
이 매개 변수는 사용되지 않습니다.
pKeystroke _Out_
형식: XINPUT_KEYSTROKE*
입력 이벤트를 수신하는 XINPUT_KEYSTROKE 구조체에 대한 포인터.
반환 값
형식: DWORD
- 함수가 성공하면 ERROR_SUCCESS를 반환합니다.
- 새 키를 누르지 않은 경우 함수가 ERROR_EMPTY를 반환합니다.
- 컨트롤러가 연결되어 있지 않거나 사용자가 활성화하지 않은 경우 함수가 ERROR_DEVICE_NOT_CONNECTED를 반환합니다. 아래의 설명 부분을 참조하세요.
- 함수가 실패하면 Winerror.h에 정의된 오류 코드를 반환합니다.
설명
무선 컨트롤러는 시스템 시작 시 활성 상태로 간주되지 않으며 무선 컨트롤러가 활성화되기 전에 XInput 함수 중 하나를 호출하면 해당 호출이 ERROR_DEVICE_NOT_CONNECTED를 반환합니다. 게임 타이틀은 반환 코드를 조사하여 이 문제를 처리할 수 있도록 준비가 되어 있어야 합니다. 유선 컨트롤러는 삽입되면 자동으로 활성화됩니다. 무선 컨트롤러는 사용자가 시작 또는 가이드 메뉴 버튼을 눌러 컨트롤러 전원을 켜면 활성화됩니다.
XInput에서 GameInput으로 포팅하는 코드가 GetKeyStroke 함수를 호출하지 않는 경우 XINPUT_ON_GAMEINPUT_NO_XINPUTGETKEYSTROKE를 정의하여 XInput 래퍼의 크기를 줄일 수 있습니다. 자세한 내용은 XInput에서 GameInput으로 포팅을 참조하세요.
요구 사항
헤더: XInputOnGameInput.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Xbox One 패밀리 콘솔 및 Xbox Series 콘솔