XINPUT_CAPABILITIES

Describe las funcionalidades de un mando conectado.

Sintaxis

typedef struct XINPUT_CAPABILITIES {  
    BYTE Type;  
    BYTE SubType;  
    WORD Flags;  
    XINPUT_GAMEPAD Gamepad;  
    XINPUT_VIBRATION Vibration;  
} XINPUT_CAPABILITIES  

Miembros

Type
Tipo: BYTE Tipo de mando. Debe ser del tipo XINPUT_DEVTYPE_GAMEPAD y tener uno de los valores enumerados en la tabla siguiente. SubType
Tipo: BYTE Subtipo del mando de juego. Subtipos permitidos:

Subtipo	Significado
XINPUT_DEVSUBTYPE_UNKNOWN	Desconocido. El tipo de mando es desconocido.
XINPUT_DEVSUBTYPE_GAMEPAD	Mando de juego. Incluye las palancas izquierda y derecha, los gatillos izquierdo y derecho, la cruceta direccional y todos los botones estándar: A, B, X, Y, START, BACK, LB, RB, LSB y RSB.
XINPUT_DEVSUBTYPE_WHEEL	Volante de carreras. El eje X de la palanca izquierda notifica la rotación del volante, el gatillo derecho es el pedal del acelerador y el gatillo izquierdo es el pedal de freno. Se incluyen la cruceta direccional y la mayoría de los botones estándar: A, B, X, Y, START, BACK, LB y RB. LSB y RSB son opcionales.
XINPUT_DEVSUBTYPE_ARCADE_STICK	Palanca arcade. Incluye una palanca digital que se notifica como DPAD (arriba, abajo, izquierda y derecha) y la mayoría de los botones estándar: A, B, X, Y, START y BACK. Los gatillos izquierdo y derecho se implementan como botones digitales y notifican 0 o 0xFF. LB, LSB, RB y RSB son opcionales.
XINPUT_DEVSUBTYPE_FLIGHT_STICK	Palanca de vuelo. Incluye una palanca de cabeceo y alabeo que se notifica como la palanca izquierda, un mando POV que se notifica como la palanca derecha, un timón (giro de la empuñadura o balancín) que se notifica como el gatillo izquierdo y un control de aceleración como el gatillo derecho. Incluye compatibilidad con un arma principal (A), un arma secundaria (B) y otros botones estándar: X, Y, START y BACK. LB, LSB, RB y RSB son opcionales.
XINPUT_DEVSUBTYPE_DANCE_PAD	Alfombra de baile. Incluye la cruceta direccional y los botones estándar (A, B, X e Y) en la alfombra, así como BACK y START.
XINPUT_DEVSUBTYPE_GUITAR XINPUT_DEVSUBTYPE_GUITAR_ALTERNATE XINPUT_DEVSUBTYPE_GUITAR_BASS	Mando de guitarra. La barra de rasgueo se asigna a DPAD (arriba y abajo), y los trastes se asignan a A (verde), B (rojo), Y (amarillo), X (azul) y LB (naranja). El eje Y de la palanca derecha está asociado a un sensor de orientación vertical, y el eje X de la palanca derecha es la palanca de trémolo. Se incluye compatibilidad con BACK, START y DPAD (izquierda, derecha). El gatillo izquierdo (selector de pastilla), el gatillo derecho, RB, LSB (modificador de trastes) y RSB son opcionales. Guitar Bass es idéntico a Guitar, con el subtipo distinto para simplificar la configuración. Guitar Alt admite un rango de movimiento mayor para el sensor de orientación vertical.
XINPUT_DEVSUBTYPE_DRUM_KIT	Mando de batería. Los pads de la batería se asignan a botones: A para el verde (Floor Tom), B para el rojo (Snare Drum), X para el azul (Low Tom), Y para el amarillo (High Tom) y LB para el pedal (Bass Drum). Se incluyen la cruceta direccional, BACK y START. RB, LSB y RSB son opcionales.
XINPUT_DEVSUBTYPE_ARCADE_PAD	Mando arcade. Incluye la cruceta direccional y la mayoría de los botones estándar: A, B, X, Y, START, BACK, LB y RB. Los gatillos izquierdo y derecho se implementan como botones digitales y notifican 0 o 0xFF. La palanca izquierda, la palanca derecha, LSB y RSB son opcionales.

Flags
Tipo: WORD Características del mando.

Valor	Descripción
XINPUT_CAPS_VOICE_SUPPORTED	El dispositivo tiene un dispositivo de voz integrado.
XINPUT_CAPS_FFB_SUPPORTED	El dispositivo admite la funcionalidad de retroalimentación de fuerza. Por el momento, las características de retroalimentación de fuerza distintas de la vibración no se admiten mediante XINPUT en Windows.
XINPUT_CAPS_WIRELESS	El dispositivo es inalámbrico.
XINPUT_CAPS_PMD_SUPPORTED	El dispositivo admite módulos conectables. Por el momento, los módulos conectables (como el dispositivo de entrada de texto (TID)) no se admiten mediante XINPUT en Windows.
XINPUT_CAPS_NO_NAVIGATION	El dispositivo carece de los botones de navegación por menús: START, BACK y DPAD.

Gamepad
Tipo: XINPUT_GAMEPAD Estructura XINPUT_GAMEPAD que describe las características de mando disponibles y las resoluciones de los controles. Vibration
Tipo: XINPUT_VIBRATION Estructura XINPUT_VIBRATION que describe la funcionalidad de vibración disponible y las resoluciones.

Comentarios

XInputGetCapabilities devuelve XINPUT_CAPABILITIES para indicar las características y la funcionalidad disponible de un mando especificado. XInputGetCapabilities establece los miembros de la estructura para indicar qué entradas admite el dispositivo. Para los controles de estado binario, como los botones digitales, el bit correspondiente refleja si el dispositivo admite el control. Para los controles proporcionales, como las palancas, el valor indica la resolución de ese control. Es posible que algunos de los bits menos significativos no estén establecidos, para indicar que el control no proporciona resolución a ese nivel. El miembro SubType indica el subtipo específico del mando presente. Los juegos pueden detectar el subtipo de mando y ajustar su gestión de la entrada o salida del mando según los subtipos más adecuados para su género de juego. Por ejemplo, un juego de carreras de coches podría comprobar la presencia de un volante para proporcionar un control más preciso del coche que se conduce. Sin embargo, los títulos no deben deshabilitar ni ignorar un dispositivo según su subtipo. Un subtipo no reconocido por el juego o para el cual el juego no está específicamente ajustado debe tratarse como un mando estándar, XINPUT_DEVSUBTYPE_GAMEPAD. Los controladores XUSB de Windows más antiguos notifican información sobre funcionalidades incompletas, especialmente para dispositivos inalámbricos. El controlador XUSB de Windows más reciente proporciona compatibilidad completa con dispositivos con cable e inalámbricos, y proporciona marcas de funcionalidades más completas y precisas.

Requisitos

Encabezado: XInputOnGameInput.h Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Portabilidad de XInput a GameInput
XInputOnGameInput

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XINPUT_CAPABILITIES

XINPUT_CAPABILITIES

Sintaxis

Miembros

Comentarios

Requisitos

Consulte también

​XINPUT_CAPABILITIES

​Sintaxis

​Miembros

​Comentarios

​Requisitos

​Consulte también

XINPUT_CAPABILITIES

Sintaxis

Miembros

Comentarios

Requisitos

Consulte también