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 :
- Trace : l'entrée a été observée pendant une course de l'utilisateur.
- GUID / SDK : la famille ou la méthode est identifiée par les constantes et structures DirectInput du SDK Windows, avec un chemin statique cohérent.
- Candidat : rôle déduit du code, encore à confirmer par des observations ciblées.
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 :
0x005C97E3lit le périphérique du canal ; une absence conduit au chemin d'erreur.0x005C97F9lit le compteur d'axes actionneurs.0x005C9800teste ce compteur.0x005C9802quitte 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 second argument de
0x005C9760est réacheminé vers la magnitude périodique ; - GUID : carrée ;
- durée :
0x249F0= 150 000 microsecondes, soit 150 ms ; - période :
0x124F8= 75 000 microsecondes, soit 75 ms ; - gain :
0x2710= 10 000 ; - décalage et phase : zéro sur ce chemin ;
- axes et directions : tableaux construits sur la pile, avec nombre d'axes issu de
0x0086FF80.
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 :
- un champ
+0x28de l'objet pointé par*this, égal à 1 ; - un champ
+0x18non nul de ce même objet ; - le gestionnaire global
0x00870760non nul ; - le résultat de
0x005BFD70(canal); - un objet global à
0x008900D8non 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 déclencheurs physiques exacts, les catégories des deux tables de saut du calcul véhicule et les mélanges d'effets ;
- la validation dynamique des familles sinus, carré alternatif, amortissement alternatif et sélecteur multi-forme ;
- le détail complet des paramètres des effets de condition et des règles de saturation ;
- les destinations effectives des appels indirects non classés ;
- le comportement des autres canaux, la reconnexion et les autres modèles de manettes ;
- les chemins d'acquisition des commandes, de configuration, des menus et de remappage, encore distincts du pont de vibrations.
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
- Index généré et appelants
- Régions, appels, branches, signatures et retours
- Tous les CALL directs décodés dans .text
- Appels directs et indirects du périmètre détaillé
- Tables de saut bornées
- Extraits de désassemblage du périmètre
- GUID relevés
- Métadonnées et limites
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é.