XInputGetKeystroke
게임패드 입력 이벤트를 검색합니다.구문
매개변수
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 콘솔참고 항목
XInput을 GameInput으로 이식XInputOnGameInput