fonction joySetCapture (joystickapi.h)
La fonction joySetCapture capture un joystick en provoquant l’envoi de ses messages à la fenêtre spécifiée.
Syntaxe
MMRESULT joySetCapture(
HWND hwnd,
UINT uJoyID,
UINT uPeriod,
BOOL fChanged
);
Paramètres
hwnd
Gérez la fenêtre pour recevoir les messages du joystick.
uJoyID
Identificateur du joystick à capturer. Les valeurs valides pour uJoyID vont de zéro (JOYSTICKID1) à 15.
uPeriod
Fréquence d’interrogation, en millisecondes.
fChanged
Changer l’indicateur de position. Spécifiez TRUE pour que ce paramètre envoie des messages uniquement lorsque la position change d’une valeur supérieure au seuil de mouvement du joystick. Sinon, les messages sont envoyés à la fréquence d’interrogation spécifiée dans uPeriod.
Valeur retournée
Retourne JOYERR_NOERROR en cas de réussite ou l’une des valeurs d’erreur suivantes.
| Code de retour | Description |
|---|---|
|
Le pilote du joystick n’est pas présent. |
|
L’ID du joystick ou hwnd non valide est NULL. |
|
Impossible de capturer l’entrée du joystick, car un service requis (tel qu’un minuteur Windows) n’est pas disponible. |
|
Le joystick spécifié n’est pas connecté au système. |
|
L’ID du joystick ou hwnd non valide est NULL. |
Notes
Si le joystick spécifié est actuellement capturé, la fonction retourne un comportement non défini. Appelez la fonction joyReleaseCapture pour libérer le joystick capturé, ou détruisez la fenêtre pour libérer automatiquement le joystick.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | joystickapi.h (inclure Windows.h) |
| Bibliothèque | Winmm.lib |
| DLL | Winmm.dll |