COR_IL_MAP-Struktur

Artikel
08/10/2011

Gibt Änderungen im relativen Offset einer Funktion an.

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

Member

Member	Beschreibungen
oldOffset	Der alte MSIL-Offset (Microsoft Intermediate Language) relativ zum Anfang der Funktion.
newOffset	Der neue MSIL-Offset relativ zum Anfang der Funktion.
fAccurate	true, wenn die Zuordnung als genau bekannt ist; andernfalls false.

Hinweise

Die Zuordnung hat folgendes Format: Der Debugger geht davon aus, das der oldOffset auf einen MSIL-Offset im ursprünglichen, unveränderten MSIL-Code verweist. Der newOffset-Parameter verweist auf den entsprechenden MSIL-Offset im neuen, instrumentierten Code.

Damit die schrittweise Ausführung richtig funktioniert, müssen die folgenden Anforderungen erfüllt sein:

Die Zuordnung sollte in aufsteigender Reihenfolge sortiert werden.
Instrumentierter MSIL-Code darf nicht neu angeordnet werden.
Ursprünglicher MSIL-Code darf nicht entfernt werden.
Die Zuordnung muss Einträge für die Zuordnung aller Sequenzpunkte von der Programmdatenbankdatei (PDB) einschließen.

Die Zuordnung interpoliert keine fehlenden Einträge. Das folgende Beispiel zeigt eine Zuordnung und ihre Ergebnisse.

Zuordnung:

0 alter Offset, 0 neuer Offset
5 alter Offset, 10 neuer Offset
9 alter Offset, 20 neuer Offset

Ergebnisse:

Ein alter Offset von 0, 1, 2, 3 oder 4 wird dem neuen Offset 0 zugeordnet.
Ein alter Offset von 5, 6, 7 oder 8 wird dem neuen Offset 10 zugeordnet.
Ein alter Offset von 9 oder höher wird dem neuem Offset 20 zugeordnet.
Ein neuer Offset von 0, 1, 2, 3, 4, 5, 6, 7, 8 oder 9 wird dem alten Offset 0 zugeordnet.
Ein neuer Offset von 10, 11, 12, 13, 14, 15, 16, 17, 18 oder 19 wird dem alten Offset 5 zugeordnet.
Ein neuer Offset von 20 oder höher wird dem alten Offset 9 zugeordnet.