COR_IL_MAP, structure

Article
08/10/2011

Spécifie les modifications dans l'offset relatif d'une fonction.

typedef struct _COR_IL_MAP {
    ULONG32 oldOffset; 
    ULONG32 newOffset; 
    BOOL    fAccurate;
} COR_IL_MAP;

Membres

Membre	Description
oldOffset	Ancien offset Microsoft Intermediate Language par rapport au début de la fonction.
newOffset	Nouvel offset MSIL par rapport au début de la fonction.
fAccurate	true si le mappage est avéré précis ; sinon false.

Notes

Le format du mappage est le suivant : le débogueur suppose que oldOffset fait référence à un offset MSIL dans le code MSIL non modifié d'origine. Le paramètre newOffset fait référence à l'offset MSIL correspondant dans le nouveau code instrumenté.

Pour que l'exécution pas à pas fonctionne correctement, les spécifications suivantes doivent être satisfaites :

Le mappage doit être trié en ordre croissant.
Le code MSIL instrumenté ne doit pas être réorganisé.
Le code MSIL d'origine ne doit pas être supprimé.
Le mappage doit inclure des entrées pour mapper tous les points de séquence du fichier de base de données de programme (PDB).

Le mappage n'interpole pas les entrées manquantes. L'exemple suivant illustre un mappage et ses résultats.

Mappage :

ancien offset 0, nouvel offset 0
ancien offset 5, nouvel offset 10
ancien offset 9, nouvel offset 20

Résultats :

Un ancien offset de 0, 1, 2, 3 ou 4 sera mappé à un nouvel offset de 0.
Un ancien offset de 5, 6, 7 ou 8 sera mappé au nouvel offset 10.
Un ancien offset de 9 ou supérieur sera mappé au nouvel offset 20.
Un nouvel offset de 0, 1, 2, 3, 4, 5, 6, 7, 8 ou 9 sera mappé à l'ancien offset 0.
Un nouvel offset de 10, 11, 12, 13, 14, 15, 16, 17, 18 ou 19 sera mappé à l'ancien offset 5.
Un nouvel offset de 20 ou supérieur sera mappé à l'ancien offset 9.