Estrutura COR_IL_MAP

  • Artigo

Especifica mudanças no deslocamento relativo de uma função.

Sintaxe

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

Membros

Membro Descrição
oldOffset A antiga linguagem intermediária comum (CIL) desloca-se em relação ao início da função.
newOffset O novo deslocamento CIL em relação ao início da função.
fAccurate true se o mapeamento for conhecido por ser preciso; caso contrário, false.

Comentários

O formato do mapa é o seguinte: O depurador assumirá que oldOffset se refere a um deslocamento CIL dentro do código CIL original não modificado. O newOffset parâmetro refere-se ao deslocamento CIL correspondente dentro do novo código instrumentado.

Para que a etapa funcione corretamente, os seguintes requisitos devem ser atendidos:

  • O mapa deve ser classificado em ordem crescente.

  • O código CIL instrumentado não deve ser reordenado.

  • O código CIL original não deve ser removido.

  • O mapa deve incluir entradas para mapear todos os pontos de sequência do arquivo PDB (banco de dados do programa).

O mapa não interpola entradas ausentes. O exemplo a seguir mostra um mapa e seus resultados.

Mapa:

  • 0 deslocamento antigo, 0 novo deslocamento

  • 5 deslocamento antigo, 10 novo deslocamento

  • 9 deslocamento antigo, 20 novo deslocamento

Resultados:

  • Um deslocamento antigo de 0, 1, 2, 3 ou 4 será mapeado para um novo deslocamento de 0.

  • Um deslocamento antigo de 5, 6, 7 ou 8 será mapeado para um novo deslocamento de 10.

  • Um deslocamento antigo de 9 ou mais será mapeado para um novo deslocamento de 20.

  • Um novo deslocamento de 0, 1, 2, 3, 4, 5, 6, 7, 8 ou 9 será mapeado para o deslocamento antigo de 0.

  • Um novo deslocamento de 10, 11, 12, 13, 14, 15, 16, 17, 18 ou 19 será mapeado para o deslocamento antigo de 5.

  • Um novo deslocamento de 20 ou mais será mapeado para o deslocamento antigo de 9.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponíveis desde a versão 1.0

Confira também