estructura XINPUT_CAPABILITIES (xinput.h)

Artículo
03/13/2024

Describe las funcionalidades de un controlador conectado. La función XInputGetCapabilities devuelve XINPUT_CAPABILITIES.

Sintaxis

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

Miembros

Type

Tipo de controlador. Debe tener uno de los siguientes valores.

Valor	Descripción
XINPUT_DEVTYPE_GAMEPAD	El dispositivo es un controlador de juego.

SubType

Subtipo del controlador de juego. Consulte XINPUT y Subtipos de controlador para obtener una lista de subtipos permitidos.

Nota Para obtener restricciones sobre el uso de este valor de subtipo, vea Comentarios. Se pueden agregar más subtipos en el futuro.

Flags

Características del controlador.

Valor	Descripción
XINPUT_CAPS_VOICE_SUPPORTED	El dispositivo tiene un dispositivo de voz integrado.
XINPUT_CAPS_FFB_SUPPORTED	El dispositivo admite la funcionalidad forzar comentarios. Tenga en cuenta que estas características de fuerza-comentarios más allá de rumble no se admiten actualmente a través de XINPUT en Windows.
XINPUT_CAPS_WIRELESS	El dispositivo es inalámbrico.
XINPUT_CAPS_PMD_SUPPORTED	El dispositivo admite módulos de complemento. Tenga en cuenta que los módulos de complemento como el dispositivo de entrada de texto (TID) no se admiten actualmente a través de XINPUT en Windows.
XINPUT_CAPS_NO_NAVIGATION	El dispositivo carece de botones de navegación de menú (START, BACK, DPAD).

Gamepad

XINPUT_GAMEPAD estructura que describe las características del controlador disponibles y las resoluciones de control.

Vibration

XINPUT_VIBRATION estructura que describe la funcionalidad y las resoluciones de vibración disponibles.

Comentarios

XInputGetCapabilities devuelve XINPUT_CAPABILITIES para indicar las características y la funcionalidad disponible de un controlador especificado.

XInputGetCapabilities establece los miembros de estructura para indicar qué entradas admite el dispositivo. En el caso de los controles de estado binario, como botones digitales, el bit correspondiente refleja si el dispositivo admite o no el control. En el caso de los controles proporcionales, como los sticks digitales, el valor indica la resolución de ese control. Es posible que no se establezca algún número de bits menos significativos, lo que indica que el control no proporciona resolución a ese nivel.

El miembro SubType indica el subtipo específico del controlador presente. Los juegos pueden detectar el subtipo de controlador y ajustar su control de la entrada o salida del controlador en función de los subtipos que son adecuados para su género de juego. Por ejemplo, un juego de carreras de coches podría comprobar la presencia de un controlador de rueda para proporcionar un control más preciso del automóvil que se está manejando. Sin embargo, los títulos no deben deshabilitar ni omitir un dispositivo en función de su subtipo. Los subtipos no reconocidos por el juego o para los que el juego no está optimizado específicamente deben tratarse como un controlador estándar (XINPUT_DEVSUBTYPE_GAMEPAD).

Los controladores de Windows XUSB antiguos informan de información de funcionalidades incompletas, especialmente para dispositivos inalámbricos. El controlador de Windows XUSB más reciente proporciona soporte completo para dispositivos cableados e inalámbricos, y marcas de funcionalidades más completas y precisas.