NFSU2 Documentation

Cartographie du retour de force natif PC

Dernière mise à jour : 17 novembre 2026. Version étudiée : EXE SHA-256 4D51643C4AD410D809183256A634B1D9126D8DF9E1AAA03DD7226EB83B9D818F, base observée 0x00400000.

Portée et niveau de preuve

La capture de code est prise après le démarrage permis par SafeDiscLoader2, avant la pose des hooks de notre trace. Elle contient les sections lisibles non modifiables du module principal. Les sections modifiables sont mises à zéro ; les deux sections exécutables/modifiables stxt774 et stxt371 du mécanisme de protection ne sont donc pas analysées ici.

L'index général contient 62 491 instructions décodées comme appels directs dans .text, et 6 418 appels indirects. Le désassemblage est linéaire : des données intégrées au code peuvent être décodées comme des instructions. Ces nombres ne sont ni un nombre de fonctions certifiées ni un nombre de chemins exécutables.

Le périmètre détaillé couvre 234 régions candidates dans 0x005BF000–0x005D2FFF et 0x00406000–0x00406A3F. Il inclut des utilitaires et du code voisin qui ne sont pas tous liés aux vibrations. Les débuts de fonctions sont proposés à partir des destinations de CALL et de certaines séquences d'alignement ; les noms sont des noms de travail.

Les mentions suivantes distinguent les preuves :

Architecture retrouvée

flowchart TD
    D["Pilote / véhicule : 0041DFC0, 00421030 (régions candidates)"] --> V["Calcul retour de force : 00406460 — observé"]
    V --> S["Ressort : 005C9150 — observé"]
    V --> C["Adaptation direction : 005C9550"]
    C --> CF["Force constante : 005C9380"]
    V --> A["Amortissement : 005C9590 — observé"]
    V --> Q["Impulsion carrée : 005C9760 — observé"]
    V --> W["Sélecteur périodique : 005C9FD0"]
    V --> AV["Variante amortissement : 005C9D90"]
    S --> CD["Créer / modifier une condition : 005C04E0 / 005C06A0"]
    A --> CD
    AV --> CD
    CF --> CC["Créer / modifier une constante : 005C0200 / 005C0390"]
    Q --> P["Créer / modifier un périodique : 005C8D20 / 005C8ED0"]
    W --> P
    CD --> DI["Interfaces DirectInput : périphérique et effets"]
    CC --> DI
    P --> DI
    Q --> B["Pont SDL3 expérimental actuel"]

Ce graphe est une synthèse des chemins retrouvés, pas un graphe complet de toutes les instructions. Les branches, appels et tables de saut sont disponibles dans les fichiers associés.

Tables globales et banques d'effets

Adresse / offset Interprétation Preuve et réserve
0x00870760 Pointeur vers le gestionnaire de commandes / forces utilisé par le calcul véhicule Chargé dans ECX avant les méthodes de force ; pointeur utilisé dans les traces
0x0086FFB4 + canal*4 Table de périphériques DirectInput par canal Utilisation comme objet COM ; entrée non nulle dans les essais
0x0086FF80 + canal*4 Nombre d'axes actionneurs de retour de force, limité à deux Callback 0x005C8660, test à 0x005C86D4 du bit DIDOI_FFACTUATOR de DIDEVICEOBJECTINSTANCE.dwFlags, incrément borné à 0x005C86E7
gestionnaire +0x2498 Banque utilisée par les effets de condition, dont ressort et amortissement Adresses calculées dans 0x005C9150, 0x005C9590, 0x005C9D90
gestionnaire +0x24E8 Banque utilisée par la force constante Adresse calculée dans 0x005C9380
gestionnaire +0x2538 Banque utilisée par les effets périodiques Adresse calculée dans les routines périodiques
banque +0x10 + 4*(slot + 8*canal) Entrée IDirectInputEffect* Calcul commun des constructeurs et de 0x005C0070

Les banques sont espacées de 0x50 octets. Le calcul des handles est compatible avec deux canaux et huit emplacements par canal, après 16 octets de métadonnées. La signification exhaustive de ces métadonnées reste à établir.

Correction de vocabulaire : le champ CSV historique effects contient la lecture de 0x0086FF80. Il faut désormais le lire comme compteur d'axes actionneurs, et non comme un pointeur d'effet ou une liste d'effets. Les CSV historiques ne sont pas réécrits pour conserver les preuves originales.

Pourquoi le chemin natif s'interrompt sur la manette testée

Dans les essais, l'entrée de périphérique est non nulle, mais le compteur d'axes actionneurs vaut zéro.

Dans 0x005C9760 :

  1. 0x005C97E3 lit le périphérique du canal ; une absence conduit au chemin d'erreur.
  2. 0x005C97F9 lit le compteur d'axes actionneurs.
  3. 0x005C9800 teste ce compteur.
  4. 0x005C9802 quitte la routine s'il est nul, avant la création ou la mise à jour de l'effet.

Cela explique le blocage observé de ce chemin DirectInput malgré des demandes du moteur. Cela n'empêche pas SDL3 d'utiliser les moteurs de vibration XInput, dont la disponibilité a été détectée puis confirmée physiquement.

Le pont actuel intervient avant cette sortie : il observe la demande native et envoie sa propre impulsion SDL3. Il n'altère pas le compteur ni les objets DirectInput du jeu.

Familles d'effets et adresses

Routine Famille retrouvée Arguments de pile Niveau de preuve
0x005C9150 Ressort (GUID_Spring) 4 (ret 0x10) GUID ; trace type 4, 324 appels dans l'instantané SDL conservé
0x005C9380 Force constante (GUID_ConstantForce) 2 (ret 8) GUID et constructeur constant
0x005C9550 Adaptateur de direction vers 0x005C9380 3 (ret 0x0C) Code statique : modulo 360 et table à this+0x25F0 ; pas observé dans les deux essais initiaux
0x005C9590 Amortissement (GUID_Damper) 2 (ret 8) GUID ; trace type 6, appelée continuellement en course
0x005C9760 Impulsion carrée (GUID_Square) 2 (ret 8) GUID ; trace type 0 ; sortie SDL3 confirmée par l'utilisateur
0x005C99D0 Sinusoïde (GUID_Sine) 2 (ret 8) GUID ; pas encore tracé
0x005C9BB0 Autre variante carrée (GUID_Square) 2 (ret 8) GUID ; pas encore tracé
0x005C9D90 Autre variante d'amortissement (GUID_Damper) 2 (ret 8) GUID ; pas encore tracé
0x005C9FD0 Sélecteur de forme périodique 4 (ret 0x10) Table de saut bornée, cinq GUID ; pas encore tracé

La famille DirectInput ne suffit pas à donner le déclencheur physique : un ressort n'est pas automatiquement un choc, ni un effet carré automatiquement un dérapage. Les événements exacts en amont restent à caractériser.

Sélecteur de forme à 0x005C9FD0

Le saut indirect à 0x005CA043 utilise la table 0x005CA38C, après comparaison de l'index avec 4 à 0x005CA03E.

Index au moment du saut Cible Forme sélectionnée
0 0x005CA04A Sinusoïde
1 0x005CA054 Carrée
2 0x005CA05E Triangle
3 0x005CA068 Dent de scie montante
4 0x005CA072 Dent de scie descendante

Il reste à vérifier l'origine et les transformations de cet index dans chaque appelant. Le cas par défaut rejoint 0x005CA07A ; sa forme effective dépend de la valeur déjà initialisée, à examiner séparément.

GUID relevés dans les données

Famille Adresse
Constante 0x007BFCF0
Carrée 0x007BFCE0
Sinusoïde 0x007BFCD0
Triangle 0x007BFCC0
Dent de scie montante 0x007BFCB0
Dent de scie descendante 0x007BFCA0
Ressort 0x007BFC90
Amortissement 0x007BFC80

L'absence des autres GUID recherchés dans cette capture ne prouve pas qu'une fonction équivalente n'existe nulle part dans le jeu.

Constructeurs et mises à jour génériques

Ces routines utilisent ECX comme objet de banque et nettoient leurs arguments de pile au retour. La correspondance est cohérente avec des méthodes __thiscall x86 ; aucun appel direct depuis notre module n'est nécessaire pour la trace actuelle.

Routine Travail Paramètres de pile Appel COM notable
0x005C0200 Construction d'une force constante 21 0x005C0348 : case +0x48, CreateEffect
0x005C0390 Modification d'une force constante 19 0x005C04B3 : case +0x18, SetParameters
0x005C04E0 Construction d'un effet de condition 22 0x005C065D : case +0x48, CreateEffect
0x005C06A0 Modification d'un effet de condition 20 0x005C07F7 : case +0x18, SetParameters
0x005C8D20 Construction d'un effet périodique 24 0x005C8E92 : case +0x48, CreateEffect
0x005C8ED0 Modification d'un effet périodique 22 0x005C901D : case +0x18, SetParameters

Paramètres retrouvés du constructeur périodique

Index à partir de zéro, hors ECX et hors adresse de retour. Il s'agit de la disposition statique reconstruite dans 0x005C8D20, à recouper avant toute invocation depuis un futur module.

Index Champ alimenté
0 Canal
1 Emplacement d'effet dans la banque
2 Adresse d'une entrée de périphérique (IDirectInputDevice* indirect)
3 DIEFFECT.dwFlags
4 dwDuration
5 dwSamplePeriod
6 dwGain
7 dwTriggerButton
8 dwTriggerRepeatInterval
9 cAxes
10, 11 Deux entrées du tableau rgdwAxes
12, 13 Deux entrées de rglDirection
14 DIPERIODIC.dwMagnitude
15 DIPERIODIC.lOffset
16 DIPERIODIC.dwPhase
17 DIPERIODIC.dwPeriod
18 DIEFFECT.dwStartDelay
19–22 Attaque : niveau et durée ; décroissance : niveau et durée, dans DIENVELOPE
23 Référence du GUID d'effet

Le code construit une structure DIEFFECT de 0x38 octets, des paramètres périodiques de 0x10 octets et une enveloppe de 0x14 octets. Ces tailles correspondent aux structures du SDK Windows utilisées ici.

Dans le modificateur périodique 0x005C8ED0, l'adresse d'entrée de périphérique et le GUID ne sont plus passés : 22 paramètres au lieu de 24. La magnitude se retrouve à l'index 13, le décalage à 14, la phase à 15 et la période à 16.

Impulsion carrée du prototype

Sur le chemin de construction à 0x005C98AC–0x005C98F4 :

Le pont SDL3 reproduit pour l'instant une impulsion tactile constante de 150 ms sur les deux moteurs, avec un gain configurable. Il ne synthétise pas encore la forme carrée de 75 ms et ne traduit pas toutes les enveloppes.

Cycle de vie des effets

Adresse Rôle identifié Preuve
0x005BFEE0 Démarrer un effet Message d'échec de démarrage et appels à l'interface d'effet
0x005BFF60 Arrêter un effet Messages d'arrêt / identifiant invalide
0x005BFFF0 Décharger un effet Messages de déchargement / identifiant invalide ; appelé avant reconstruction
0x005C0070 Vérifier l'état d'un effet GetEffectStatus à 0x005C0093, comparaison de l'état à 1
0x005C00B0 Régler le gain global SetProperty avec DIPROP_FFGAIN ; valeur d'entrée limitée à 100
0x005C0140 Lire le gain global Code et message d'échec de lecture
0x005C8660 Énumérer/configurer les axes et compter les actionneurs Champs de DIDEVICEOBJECTINSTANCE et DIDOI_FFACTUATOR
0x005C8700 Lire le canal, acquérir le périphérique et activer les actionneurs Messages explicites et SendForceFeedbackCommand

Les cases des vtables sont relatives à l'interface, pas des adresses absolues de DLL :

Interface Offset x86 Méthode
IDirectInputDevice +0x14 GetProperty
IDirectInputDevice +0x18 SetProperty
IDirectInputDevice +0x1C Acquire
IDirectInputDevice +0x24 GetDeviceState
IDirectInputDevice +0x48 CreateEffect
IDirectInputDevice +0x58 SendForceFeedbackCommand
IDirectInputDevice +0x64 Poll
IDirectInputEffect +0x18 SetParameters
IDirectInputEffect +0x1C Start
IDirectInputEffect +0x20 Stop
IDirectInputEffect +0x24 GetEffectStatus
IDirectInputEffect +0x28 Download
IDirectInputEffect +0x2C Unload

Il ne faut pas appliquer ce tableau à n'importe quel appel +0x18 ou +0x48 du jeu : les interfaces graphiques et les objets internes possèdent également des vtables.

Conditions en amont du calcul véhicule

Le début de 0x00406460 teste notamment :

  1. un champ +0x28 de l'objet pointé par *this, égal à 1 ;
  2. un champ +0x18 non nul de ce même objet ;
  3. le gestionnaire global 0x00870760 non nul ;
  4. le résultat de 0x005BFD70(canal) ;
  5. un objet global à 0x008900D8 non nul, dont le premier mot vaut 4.

Ces tests sont relevés, mais la signification complète des champs n'est pas certifiée. Les nommer « joueur local », « pause », « état de course », etc. sans recoupement serait prématuré.

Le calcul contient aussi deux tables de saut à 0x004069E4 et 0x00406A0C, chacune à dix entrées bornées. Leur contenu est exporté dans jump-tables.json. Les catégories physiques ou de surface associées aux index restent à établir.

Couverture réelle et points encore ouverts

L'instantané conservé de l'essai SDL contient : 7 124 entrées du calcul véhicule, 7 124 demandes d'amortissement, 324 demandes de ressort, trois impulsions carrées, aucune création/mise à jour périodique native et aucune perte signalée. L'utilisateur a confirmé F8 et certaines vibrations en jeu.

À compléter avant d'annoncer un support complet :

Les répertoires d'import du PE capturé ne permettent pas ici de reconstruire une liste normale d'importations avec dumpbin /imports. Les appels via tables runtime ne sont donc pas tous nommés automatiquement. Cela est conservé comme limite de la capture, sans inventer leurs destinations.

Documents et données associés

Sources de confrontation : dinput.h du SDK Windows 10.0.26100.0, capture locale du jeu de l'utilisateur, traces conservées et code d'XtendedInput comme référence de départ. Aucun symbole original ni source propriétaire n'a été récupéré.