Funzione XInputGetCapabilities (xinput.h)

  • Articolo

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

Nota La versione legacy DIPUT 9.1.0 (inclusa in Windows Vista e versioni successive) ha sempre restituito un set fisso di funzionalità indipendentemente dal dispositivo collegato.
 

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

Vedi anche

Funzioni XInput

XInputGetState

XInputSetState