Skip to main content

XInputGetCapabilities

연결된 컨트롤러의 기능과 특성을 검색합니다.

구문

매개변수

dwUserIndex   _In_
형식: DWORD
장치와 연결된 게이머의 인덱스입니다. 값은 0에서 XUSER_MAX_COUNT - 1 범위입니다. dwFlags   _In_
형식: DWORD
컨트롤러 유형을 식별하는 입력 플래그입니다. 이 값이 0이면 시스템에 연결된 모든 컨트롤러의 기능이 반환됩니다. 현재는 XINPUT_FLAG_GAMEPAD만 지원됩니다. pCapabilities   _Out_
형식: XINPUT_CAPABILITIES*
컨트롤러 기능을 받는 XINPUT_CAPABILITIES 객체에 대한 포인터입니다.

반환값

형식: DWORD 함수가 성공하면 반환값은 ERROR_SUCCESS입니다. 컨트롤러가 연결되어 있지 않으면 반환값은 ERROR_DEVICE_NOT_CONNECTED입니다. 함수가 실패하면 반환값은 WinError.h에 정의된 오류 코드입니다. 함수는 호출 스레드의 마지막 오류 코드를 설정하기 위해 SetLastError를 사용하지 않습니다.

설명

레거시 XINPUT 9.1.0 버전(Windows Vista 이상 포함)은 연결된 장치와 관계없이 항상 고정된 기능 집합을 반환했습니다.
보고되는 기능에 대한 자세한 내용은 XINPUT_CAPABILITIES를 참조하세요. 자세한 내용은 XInputOnGameInput 래퍼를 참조하세요.

요구 사항

헤더: XInputOnGameInput.h 라이브러리: xgameruntime.lib 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

참고 항목

XInput에서 GameInput으로 이식
XInputOnGameInput
마지막 수정일 2026년 8월 24일