NFSU2 : relevé initial pour le module SDL3 / XInput
Mise à jour après les essais en course
La trace dynamique et un premier pont SDL3 ont été développés après ce relevé initial. L'utilisateur a confirmé les vibrations du test F8 et de certains événements natifs. Voir SDL3-PROTOTYPE.md pour le périmètre précis et TRACE-RESULTATS-ESSAI2.md pour les observations précédant le pont. Le support complet des commandes et de tous les retours tactiles n'est pas encore réalisé.
Résultat obtenu
Le plugin NFSU2_InputAudit.asi a été compilé en Win32 et chargé par Ultimate ASI Loader dans la copie NFSU2-dev. Il a vérifié le SHA-256 du fichier installé, relevé les instructions en mémoire et produit une capture des sections non modifiables. Le désassemblage x86 de cette capture est disponible dans l'espace de travail.
Ce module ne remplace pas encore les entrées et n'active aucune vibration. Il n'installe pas de hook et n'écrit pas dans la mémoire du jeu. Son initialisation se fait via InitializeASI, hors de DllMain.
Version étudiée
- EXE SHA-256 :
4D51643C4AD410D809183256A634B1D9126D8DF9E1AAA03DD7226EB83B9D818F. - Base de l'image observée :
0x00400000. - Taille de l'image virtuelle :
0x00537000. - Capture effectuée après le déchiffrement du code par le mécanisme de lancement déjà installé.
- Les noms ci-dessous sont des noms de travail ; les symboles du code source original ne sont pas disponibles.
Points d'entrée des commandes
| Adresse virtuelle | Observation | État de validation |
|---|---|---|
0x0057ED80 |
CALL 0x00579550, candidat d'initialisation joystick d'XtendedInput |
Instruction et destination vérifiées dans la capture |
0x005D2C97 |
CALL 0x005BF860, lecture des commandes selon XtendedInput |
Instruction et destination vérifiées |
0x005D04B3 |
Appel indirect d'énumération DirectInput à 0x005D04C5 |
Code présent ; identification par structure et contexte |
0x005CFD7D |
Chemin de traitement du tampon joystick | Candidat hérité d'XtendedInput, code relevé |
0x00572120 |
Recherche de configuration des événements selon XtendedInput | Code présent ; fonction à caractériser davantage |
0x005D2C83 |
CALL 0x005CFA10, chemin de lecture des périphériques que désactive XtendedInput |
Instruction et destination vérifiées |
Le relevé initial des globals 0x008654A4 et 0x00870990 vaut zéro au moment où le plugin démarre. Cela ne valide pas leur rôle pendant une course : il faudra des observations après initialisation du jeu.
Retour de force : observations nouvelles sur cette version
Création d'un effet périodique
Une routine commence à 0x005C8D20 et construit une structure de taille 0x38. À 0x005C8E92, elle appelle la case de vtable +0x48 d'un périphérique. Dans l'interface DirectInput du SDK Windows, cette case correspond à CreateEffect.
L'échec aboutit au message référencé à 0x007A3FA0 : ERROR: Failed to create periodic effect on channel %d. La concordance du code, de la structure et du message rend l'identification de ce chemin solide, même sans observation dynamique d'un effet en course.
Mise à jour de l'effet
La routine à 0x005C8ED0 construit également une structure d'effet et appelle +0x18 à 0x005C901D. Cela correspond à IDirectInputEffect::SetParameters. Le message d'échec voisin, à 0x007A3FD8, concerne la mise à jour d'une force périodique.
Commande des actionneurs
Le chemin à 0x005C8700 utilise une table de périphériques candidate à 0x0086FFB4, indexée par canal. À 0x005C8769, l'appel indirect +0x58 reçoit 0x10, cohérent avec SendForceFeedbackCommand(DIGFFS_SETACTUATORSON). Le message d'échec à 0x007A3F1C mentionne explicitement l'activation des actionneurs.
Appelants à étudier
Une routine à 0x005C9760 appelle les chemins de création et de mise à jour ci-dessus. Elle vérifie des handles de périphérique et des états internes avant de produire des effets. Un périphérique sans capacités de retour de force peut donc empêcher ces appels d'être atteints.
Ces observations ne permettent pas encore d'affirmer que cette routine correspond à une collision, au moteur ou à une perte d'adhérence. Aucun offset de vitesse ou de régime moteur n'est certifié.
La chaîne COVibration à 0x007943CC est présente, mais une chaîne de ce nom ne prouve pas à elle seule un lien avec les moteurs de la manette : elle reste une piste.
Conséquences pour l'implémentation
- Garder séparés l'acquisition des commandes via SDL3 et le calcul des vibrations issues du jeu.
- Valider les signatures et conventions d'appel avant de poser un hook.
- Observer les appelants du retour de force pendant des événements contrôlés, avec et sans périphérique DirectInput compatible.
- Déterminer si le pont doit traduire les effets natifs ou lire des événements plus hauts dans le moteur, notamment si les vérifications de capacités court-circuitent le chemin natif.
- Traduire ensuite les intensités et durées vers les deux moteurs SDL3, avec arrêt à la déconnexion et lorsque le jeu perd le focus. Le retour de force d'un volant ne se transpose pas directement en deux intensités de vibration.
Reproduction et fichiers
- Source du relevé :
src/audit.cpp. - Projet :
InputAudit.vcxproj, Release / Win32, toolset v143 et SDK 10.0.26100.0. - Bibliothèque produite :
build/NFSU2_InputAudit.asi. - Installation de diagnostic seulement :
NFSU2-dev/scripts/NFSU2_InputAudit.asi. - Relevé produit par le jeu :
NFSU2-dev/scripts/audit/addresses.txt. - Capture d'analyse :
NFSU2-dev/scripts/audit/runtime-readonly.pe.
La capture contient les en-têtes et les sections lisibles non modifiables du module principal. Les sections modifiables sont laissées à zéro : ce fichier sert à l'analyse et ne remplace pas un exécutable jouable. Les points d'accroche doivent rester des candidats tant qu'ils ne sont pas validés en conditions de jeu.
La copie jouable NFSU2-test et l'installation originale sur H: n'ont pas reçu ce module.
Références
- NFSU-XtendedInput, Xan1242, utilisé pour orienter la recherche des entrées ; son code liste encore les vibrations comme fonction à réaliser.
- En-tête
dinput.hdu SDK Windows local pour l'ordre des méthodes COM et les constantes. - SDL3 Gamepad API, cible du futur backend de manettes.