XINPUT_CAPABILITIES struttura (xinput.h)
Descrive le funzionalità di un controller connesso. La funzione XInputGetCapabilities restituisce XINPUT_CAPABILITIES.
Sintassi
typedef struct _XINPUT_CAPABILITIES {
BYTE Type;
BYTE SubType;
WORD Flags;
XINPUT_GAMEPAD Gamepad;
XINPUT_VIBRATION Vibration;
} XINPUT_CAPABILITIES, *PXINPUT_CAPABILITIES;
Members
Type
Tipo di controller. Deve essere uno dei valori seguenti.
| Valore | Descrizione |
|---|---|
| XINPUT_DEVTYPE_GAMEPAD | Il dispositivo è un controller di gioco. |
SubType
Sottotipo del controller di gioco. Per un elenco di sottotipi consentiti, vedere XINPUT e Sottotipi controller .
Flags
Funzionalità del controller.
| Valore | Descrizione |
|---|---|
| XINPUT_CAPS_VOICE_SUPPORTED | Il dispositivo ha un dispositivo vocale integrato. |
| XINPUT_CAPS_FFB_SUPPORTED | Il dispositivo supporta la funzionalità di feedback forza. Si noti che queste funzionalità di forza-feedback oltre il rumble non sono attualmente supportate tramite XINPUT in Windows. |
| XINPUT_CAPS_WIRELESS | Il dispositivo è wireless. |
| XINPUT_CAPS_PMD_SUPPORTED | Il dispositivo supporta moduli plug-in. Si noti che i moduli plug-in come il dispositivo di input di testo (TID) non sono attualmente supportati tramite XINPUT in Windows. |
| XINPUT_CAPS_NO_NAVIGATION | Il dispositivo manca dei pulsanti di spostamento dei menu (START, BACK, DPAD). |
Gamepad
XINPUT_GAMEPAD struttura che descrive le funzionalità e le risoluzioni del controllo disponibili del controller.
Vibration
XINPUT_VIBRATION struttura che descrive le funzionalità e le risoluzioni delle vibrazioni disponibili.
Commenti
XInputGetCapabilities restituisce XINPUT_CAPABILITIES per indicare le caratteristiche e le funzionalità disponibili di un controller specificato.
XInputGetCapabilities imposta i membri della struttura per indicare quali input supporta il dispositivo. Per i controlli dello stato binario, ad esempio i pulsanti digitali, il bit corrispondente riflette se il controllo è supportato dal dispositivo. Per i controlli proporzionali, ad esempio le levette, il valore indica la risoluzione per tale controllo. Alcuni bit meno significativi potrebbero non essere impostati, indicando che il controllo non fornisce la risoluzione a tale livello.
Il membro SubType indica il sottotipo specifico del controller presente. I giochi possono rilevare il sottotipo del controller e ottimizzare la gestione dell'input o dell'output del controller in base ai sottotipi adatti al genere di gioco. Ad esempio, un gioco di corse di auto potrebbe verificare la presenza di un controller ruota per fornire un controllo più fine dell'auto guidata. Tuttavia, i titoli non devono disabilitare o ignorare un dispositivo in base al relativo sottotipo. I sottotipi non riconosciuti dal gioco o per i quali il gioco non è ottimizzato in modo specifico devono essere considerati come controller standard (XINPUT_DEVSUBTYPE_GAMEPAD).
I driver windows XUSB meno recenti segnalano informazioni sulle funzionalità incomplete, in particolare per i dispositivi wireless. Il driver windows XUSB più recente offre supporto completo per i dispositivi cablati e wireless e più completi e accurati flag di funzionalità.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | xinput.h |