XINPUT_CAPABILITIES 구조체(xinput.h)

아티클
03/05/2024

연결된 컨트롤러의 기능을 설명합니다. XInputGetCapabilities 함수는 XINPUT_CAPABILITIES 반환합니다.

구문

typedef struct _XINPUT_CAPABILITIES {
  BYTE             Type;
  BYTE             SubType;
  WORD             Flags;
  XINPUT_GAMEPAD   Gamepad;
  XINPUT_VIBRATION Vibration;
} XINPUT_CAPABILITIES, *PXINPUT_CAPABILITIES;

멤버

Type

컨트롤러 유형입니다. 다음 값 중 하나여야 합니다.

값	Description
XINPUT_DEVTYPE_GAMEPAD	디바이스는 게임 컨트롤러입니다.

SubType

게임 컨트롤러의 하위 유형입니다. 허용되는 하위 형식 목록은 XINPUT 및 컨트롤러 하위 형식을 참조하세요.

참고 이 하위 형식 값의 사용에 대한 제한 사항은 비고를 참조하세요. 나중에 더 많은 하위 형식이 추가될 수 있습니다.

Flags

컨트롤러의 기능입니다.

값	Description
XINPUT_CAPS_VOICE_SUPPORTED	디바이스에 통합 음성 디바이스가 있습니다.
XINPUT_CAPS_FFB_SUPPORTED	디바이스는 힘 피드백 기능을 지원합니다. 이러한 힘 피드백 기능은 현재 Windows의 XINPUT를 통해 지원되지 않습니다.
XINPUT_CAPS_WIRELESS	디바이스가 무선입니다.
XINPUT_CAPS_PMD_SUPPORTED	디바이스는 플러그 인 모듈을 지원합니다. TID(텍스트 입력 디바이스)와 같은 플러그 인 모듈은 현재 Windows의 XINPUT를 통해 지원되지 않습니다.
XINPUT_CAPS_NO_NAVIGATION	디바이스에 메뉴 탐색 단추(시작, 뒤로, DPAD)가 없습니다.

Gamepad

사용 가능한 컨트롤러 기능 및 제어 해상도를 설명하는 XINPUT_GAMEPAD 구조입니다.

Vibration

사용 가능한 진동 기능 및 해상도를 설명하는 XINPUT_VIBRATION 구조입니다.

설명

XInputGetCapabilities 는 지정된 컨트롤러의 특징과 사용 가능한 기능을 나타내기 위해 XINPUT_CAPABILITIES 반환합니다.

XInputGetCapabilities 는 디바이스가 지원하는 입력을 나타내도록 구조체 멤버를 설정합니다. 디지털 단추와 같은 이진 상태 컨트롤의 경우 해당 비트는 디바이스에서 컨트롤을 지원하는지 여부를 반영합니다. thumbsticks와 같은 비례 컨트롤의 경우 값은 해당 컨트롤의 해상도를 나타냅니다. 컨트롤이 해당 수준에 대한 해상도를 제공하지 않음을 나타내는 몇 가지 가장 중요한 비트가 설정되지 않을 수 있습니다.

SubType 멤버는 존재하는 컨트롤러의 특정 하위 형식을 나타냅니다. 게임은 컨트롤러 하위 유형을 감지하고 게임 장르에 적합한 하위 형식을 기반으로 컨트롤러 입력 또는 출력 처리를 조정할 수 있습니다. 예를 들어, 자동차 경주 게임은 운전 중인 자동차의 세밀한 제어를 제공하기 위해 휠 컨트롤러의 존재에 대한 검사 수 있습니다. 그러나 타이틀은 하위 유형에 따라 디바이스를 사용하지 않도록 설정하거나 무시해서는 안 됩니다. 게임에서 인식되지 않거나 게임이 특별히 조정되지 않은 하위 형식은 표준 컨트롤러(XINPUT_DEVSUBTYPE_GAMEPAD)로 처리되어야 합니다.

이전 XUSB Windows 드라이버는 특히 무선 장치의 불완전한 기능 정보를 보고합니다. 최신 XUSB Windows 드라이버는 유선 및 무선 디바이스에 대한 전폭적인 지원과 보다 완전하고 정확한 기능 플래그를 제공합니다.