Condividi tramite

Struttura COR_IL_MAP

  • Articolo

Specifica le modifiche nell'offset relativo di una funzione.

Sintassi

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

Membri

Membro Descrizione
oldOffset Offset CIL (Common Intermediate Language) precedente rispetto all'inizio della funzione.
newOffset Nuovo offset CIL rispetto all'inizio della funzione.
fAccurate true se il mapping è noto per essere accurato; in caso contrario, false.

Osservazioni:

Il formato della mappa è il seguente: il debugger presuppone che oldOffset faccia riferimento a un offset CIL all'interno del codice CIL originale non modificato. Il newOffset parametro fa riferimento all'offset CIL corrispondente all'interno del nuovo codice instrumentato.

Per il corretto funzionamento delle istruzioni, è necessario soddisfare i requisiti seguenti:

  • La mappa deve essere ordinata in ordine crescente.

  • Il codice CIL instrumentato non deve essere riordinato.

  • Il codice CIL originale non deve essere rimosso.

  • La mappa deve includere voci per eseguire il mapping di tutti i punti di sequenza dal file PDB (Program Database).

La mappa non interpola le voci mancanti. L'esempio seguente mostra una mappa e i relativi risultati.

Mappa:

  • 0 offset precedente, 0 nuovo offset

  • 5 offset precedente, 10 nuovo offset

  • 9 offset precedente, 20 nuovi offset

Risultati:

  • Un offset precedente di 0, 1, 2, 3 o 4 verrà mappato a un nuovo offset pari a 0.

  • Un offset precedente di 5, 6, 7 o 8 verrà mappato al nuovo offset 10.

  • Verrà eseguito il mapping di un offset precedente di 9 o superiore a un nuovo offset 20.

  • Verrà eseguito il mapping di un nuovo offset pari a 0, 1, 2, 3, 4, 5, 6, 7, 8 o 9.

  • Un nuovo offset di 10, 11, 12, 13, 14, 15, 16, 17, 18 o 19 verrà mappato all'offset precedente 5.

  • Verrà eseguito il mapping di un nuovo offset di 20 o superiore all'offset precedente 9.

Requisiti

Piattaforme: vedere Requisiti di sistema.

Intestazione: CorDebug.idl, CorProf.idl

Libreria: CorGuids.lib

Versioni di .NET Framework: disponibili dalla versione 1.0

Vedi anche