Поделиться через

структура XINPUT_CAPABILITIES (xinput.h)

  • Статья

Описывает возможности подключенного контроллера. Функция XInputGetCapabilities возвращает XINPUT_CAPABILITIES.

Синтаксис

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

Члены

Type

Тип контроллера. Это должно быть одно из следующих значений.

Значение Описание
XINPUT_DEVTYPE_GAMEPAD Устройство является игровым контроллером. 

SubType

Подтип игрового контроллера. Список разрешенных подтипов см. в разделе Подтипы XINPUT и контроллера .

Примечание Ограничения на использование этого значения подтипа см. в разделе Примечания. В будущем может быть добавлено больше подтипов.
 

Flags

Функции контроллера.

Значение Описание
XINPUT_CAPS_VOICE_SUPPORTED Устройство имеет интегрированное голосовое устройство.
XINPUT_CAPS_FFB_SUPPORTED Устройство поддерживает функцию принудительной обратной связи. Обратите внимание, что эти функции принудительной обратной связи, помимо гула, в настоящее время не поддерживаются через XINPUT в Windows.
XINPUT_CAPS_WIRELESS Устройство является беспроводным.
XINPUT_CAPS_PMD_SUPPORTED Устройство поддерживает подключаемые модули. Обратите внимание, что подключаемые модули, такие как устройство ввода текста (TID), в настоящее время не поддерживаются через XINPUT в Windows.
XINPUT_CAPS_NO_NAVIGATION На устройстве отсутствуют кнопки навигации по меню (START, BACK, DPAD).

Gamepad

XINPUT_GAMEPAD структура, описывающая доступные функции контроллера и разрешения элементов управления.

Vibration

XINPUT_VIBRATION структура, описывающая доступные функции вибрации и разрешения.

Комментарии

XInputGetCapabilities возвращает XINPUT_CAPABILITIES для указания характеристик и доступных функций указанного контроллера.

XInputGetCapabilities задает элементы структуры, указывающие, какие входные данные поддерживает устройство. Для элементов управления двоичным состоянием, таких как цифровые кнопки, соответствующий бит отражает, поддерживается ли элемент управления устройством. Для пропорциональных элементов управления, таких как стик, значение указывает разрешение для этого элемента управления. Возможно, не задано некоторое количество наименее значимых битов, что указывает на то, что элемент управления не обеспечивает разрешение на этот уровень.

Элемент SubType указывает конкретный подтип присутствующего контроллера. Игры могут обнаруживать подтип контроллера и настраивать обработку ввода или вывода контроллера на основе подтипов, которые хорошо подходят для их игрового жанра. Например, автомобильная гоночная игра может проверка наличие контроллера колеса, чтобы обеспечить более точное управление автомобилем. Однако заголовки не должны отключать или игнорировать устройство на основе его подтипа. Подтипы, которые не распознаются игрой или для которых игра не настроена специально, следует рассматривать как стандартный контроллер (XINPUT_DEVSUBTYPE_GAMEPAD).

Старые драйверы XUSB Для Windows сообщают неполные сведения о возможностях, особенно для беспроводных устройств. Последняя версия драйвера XUSB для Windows обеспечивает полную поддержку проводных и беспроводных устройств, а также более полные и точные флаги возможностей.

Требования

Требование Значение
Заголовок xinput.h

См. также раздел

XINPUT_GAMEPAD

XINPUT_VIBRATION

Структуры XInput

XInputGetCapabilities