XInputGetKeystroke
Récupère un événement d’entrée de manette.Syntaxe
Paramètres
dwUserIndex _In_Type : DWORD Index du joueur connecté associé à l’appareil. Valeur comprise entre 0-XUSER_MAX_COUNT et 1 ; XUSER_INDEX_ANY permet de récupérer le prochain événement d’entrée disponible de n’importe quel utilisateur. dwReserved
Type : Reserved Ce paramètre n’est pas utilisé. pKeystroke _Out_
Type : XINPUT_KEYSTROKE* Pointeur vers une structure XINPUT_KEYSTROKE qui reçoit un événement d’entrée.
Valeur renvoyée
Type : DWORD- Si la fonction réussit, elle renvoie ERROR_SUCCESS.
- Si aucune nouvelle touche n’a été enfoncée, la fonction renvoie ERROR_EMPTY.
- Si la manette n’est pas connectée ou si l’utilisateur ne l’a pas activée, la fonction renvoie ERROR_DEVICE_NOT_CONNECTED ; consultez la section Remarques ci-dessous.
- Si la fonction échoue, elle renvoie un code d’erreur défini dans Winerror.h.
Remarques
Les manettes sans fil ne sont pas considérées comme actives au démarrage du système ; si l’une des fonctions XInput est appelée avant qu’une manette sans fil ne soit activée, cet appel renvoie ERROR_DEVICE_NOT_CONNECTED. Les titres de jeu doivent examiner le code de retour et être prêts à gérer cette situation. Les manettes filaires sont automatiquement activées lorsqu’elles sont branchées. Les manettes sans fil sont activées lorsque l’utilisateur appuie sur le bouton START ou Guide pour allumer la manette. Si le code que vous portez de XInput vers GameInput n’appelle pas la fonction GetKeyStroke, vous pouvez réduire la taille du wrapper XInput en définissant XINPUT_ON_GAMEINPUT_NO_XINPUTGETKEYSTROKE. Pour plus d’informations, consultez Portage de XInput vers GameInput.Configuration requise
En-tête : XInputOnGameInput.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
Porter XInput vers GameInputXInputOnGameInput