XInputGetKeystroke
Récupère un événement d’entrée de la 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 sert à 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 de retour
Type : DWORD- Si la fonction réussit, elle retourne ERROR_SUCCESS.
- Si aucune nouvelle touche n’a été enfoncée, la fonction retourne ERROR_EMPTY.
- Si la manette n’est pas connectée ou si l’utilisateur ne l’a pas activée, la fonction retourne ERROR_DEVICE_NOT_CONNECTED; consultez la section Remarques ci-dessous.
- Si la fonction échoue, elle retourne 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 une fonction XInput est appelée avant qu’une manette sans fil soit activée, cet appel retourne ERROR_DEVICE_NOT_CONNECTED. Les titres de jeux doivent examiner le code de retour et être prêts à gérer cette situation. Les manettes avec fil 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 d’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 d’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