funzione joyGetDevCapsA (joystickapi.h)

Articolo
11/20/2024

Il joyGetDevCaps funzione esegue una query su un joystick per determinarne le funzionalità.

Sintassi

MMRESULT joyGetDevCapsA(
  UINT_PTR   uJoyID,
  LPJOYCAPSA pjc,
  UINT       cbjc
);

Parametri

uJoyID

Identificatore del joystick su cui eseguire una query. I valori validi per uJoyID sono compresi tra -1 e 15. Un valore di -1 consente il recupero del membro szRegKey del della struttura di JOYCAPS, indipendentemente dal fatto che un dispositivo sia 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.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	joystickapi.h (include Windows.h)
libreria	Winmm.lib
dll	Winmm.dll

Vedere anche

joystick
Funzioni joystick multimediali

Condividi tramite