Funzione XInputGetCapabilities (xinput.h)
Recupera le funzionalità e le funzionalità di un controller connesso.
Sintassi
DWORD XInputGetCapabilities(
[in] DWORD dwUserIndex,
[in] DWORD dwFlags,
[out] XINPUT_CAPABILITIES *pCapabilities
);
Parametri
[in] dwUserIndex
Indice del controller dell'utente. Può essere un valore compreso nell'intervallo 0-3. Per informazioni su come viene determinato questo valore e sul modo in cui il valore esegue il mapping agli indicatori nel controller, vedere Più controller.
[in] dwFlags
Flag di input che identificano il tipo di controller. Se questo valore è 0, vengono restituite le funzionalità di tutti i controller connessi al sistema. Attualmente è supportato un solo valore:
| Valore | Descrizione |
|---|---|
| XINPUT_FLAG_GAMEPAD | Limitare la query ai dispositivi di tipo controller. |
Qualsiasi valore di dwflags diverso da quello precedente o 0 non è valido e genererà un'interruzione di errore durante il debug.
[out] pCapabilities
Puntatore a una struttura XINPUT_CAPABILITIES che riceve le funzionalità del controller.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.
Se il controller non è connesso, il valore restituito viene ERROR_DEVICE_NOT_CONNECTED.
Se la funzione ha esito negativo, il valore restituito è un codice di errore definito in WinError.h. La funzione non usa SetLastError per impostare l'ultimo codice di errore del thread chiamante.
Commenti
Requisiti della piattaforma
Windows 8 (XInput 1.4), DirectX SDK (XInput 1.3), Windows Vista (XInput 9.1.0)Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | xinput.h |
| Libreria | Xinput.lib; Xinput9_1_0.lib |
| DLL | Xinput1_4.dll; Xinput9_1_0.dll |