funzione joyGetDevCapsW (joystickapi.h)

La funzione joyGetDevCaps esegue una query su un joystick per determinare le sue funzionalità.

Sintassi

MMRESULT joyGetDevCapsW(
  UINT_PTR   uJoyID,
  LPJOYCAPSW 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
MMSYSERR_NODRIVER
Il driver del joystick non è presente o l'identificatore del joystick specificato non è valido. L'identificatore del joystick specificato non è valido.
MMSYSERR_INVALPARAM
È 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

   
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

Vedi anche

Joystick

Funzioni del joystick multimediale