NFSU2 Documentation

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

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

  1. Garder séparés l'acquisition des commandes via SDL3 et le calcul des vibrations issues du jeu.
  2. Valider les signatures et conventions d'appel avant de poser un hook.
  3. Observer les appelants du retour de force pendant des événements contrôlés, avec et sans périphérique DirectInput compatible.
  4. 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.
  5. 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

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