XInputGetCapabilities
연결된 컨트롤러의 기능을 검색합니다.
구문
DWORD XInputGetCapabilities(
DWORD dwUserIndex,
DWORD dwFlags,
XINPUT_CAPABILITIES * pCapabilities
)
매개 변수
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 콘솔