funzione joyGetDevCapsA (joystickapi.h)
La funzione joyGetDevCaps esegue una query su un joystick per determinare le sue funzionalità.
Sintassi
MMRESULT joyGetDevCapsA(
UINT_PTR uJoyID,
LPJOYCAPSA pjc,
UINT cbjc
);
Parametri
uJoyID
Identificatore del joystick da eseguire una query. Valori validi per l'intervallo uJoyID compreso tra -1 e 15. Il valore -1 consente il recupero del membro szRegKey della struttura JOYCAPS se un dispositivo è presente o meno.
pjc
Puntatore a una struttura JOYCAPS per contenere le funzionalità del joystick.
cbjc
Dimensioni, in byte, della struttura JOYCAPS .
Valore restituito
Restituisce JOYERR_NOERROR se ha esito positivo o uno dei valori di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il driver del joystick non è presente o l'identificatore del joystick specificato non è valido. L'identificatore del joystick specificato non è valido. |
|
È stato passato un parametro non valido. |
Commenti
Usare la funzione joyGetNumDevs per determinare il numero di dispositivi joystick supportati dal driver.
Questo metodo ha esito negativo quando viene passato un valore non valido per il parametro cbjc .
Nota
L'intestazione joystickapi.h definisce joyGetDevCaps come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | joystickapi.h (include Windows.h) |
| Libreria | Winmm.lib |
| DLL | Winmm.dll |