estructura XINPUT_CAPABILITIES (xinput.h)
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.
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.
Requisitos
| Requisito | Valor |
|---|---|
| Header | xinput.h |