XInputGetCapabilities 함수(xinput.h)

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

구문

DWORD XInputGetCapabilities(
  [in]  DWORD               dwUserIndex,
  [in]  DWORD               dwFlags,
  [out] XINPUT_CAPABILITIES *pCapabilities
);

매개 변수

[in] dwUserIndex

사용자 컨트롤러의 인덱스입니다. 0~3 범위의 값일 수 있습니다. 이 값을 결정하는 방법과 값이 컨트롤러의 지표에 매핑되는 방법에 대한 자세한 내용은 여러 컨트롤러를 참조하세요.

[in] dwFlags

컨트롤러 유형을 식별하는 입력 플래그입니다. 이 값이 0이면 시스템에 연결된 모든 컨트롤러의 기능이 반환됩니다. 현재는 하나의 값만 지원됩니다.

값	Description
XINPUT_FLAG_GAMEPAD	쿼리를 컨트롤러 유형의 디바이스로 제한합니다.

 

위 또는 0 이외의 dwflags 값은 잘못되었으며 디버깅할 때 오류가 발생합니다.

[out] pCapabilities

컨트롤러 기능을 수신하는 XINPUT_CAPABILITIES 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

컨트롤러가 연결되어 있지 않으면 반환 값이 ERROR_DEVICE_NOT_CONNECTED.

함수가 실패하면 반환 값은 WinError.h에 정의된 오류 코드입니다. 함수는 SetLastError 를 사용하여 호출 스레드의 마지막 오류 코드를 설정하지 않습니다.

설명

참고 레거시 XINPUT 9.1.0 버전(Windows Vista 이상에 포함됨)은 연결된 디바이스에 관계없이 항상 고정된 기능 집합을 반환했습니다.

 

플랫폼 요구 사항

Windows 8(XInput 1.4), DirectX SDK(XInput 1.3), Windows Vista(XInput 9.1.0)

요구 사항

대상 플랫폼	Windows
헤더	xinput.h
라이브러리	Xinput.lib; Xinput9_1_0.lib
DLL	Xinput1_4.dll; Xinput9_1_0.dll

추가 정보

XInput 함수

XInputGetState

XInputSetState