ICorDebugILCode2::Método GetInstrumentedILMap

  • Artigo

[Com suporte no .NET Framework 4.5.2 e versões posteriores]

Retorna um mapa dos deslocamentos da linguagem intermediária (IL) instrumentados pelo criador de perfis para os deslocamentos da IL do método original para esta instância.

Sintaxe

HRESULT GetInstrumentedILMap(  
   [in] ULONG32 cMap,  
   [out] ULONG32 *pcMap,  
   [out, size_is(cMap), length_is(*pcMap)] COR_IL_MAP map[]  
);

Parâmetros

cMap
[in] A capacidade de armazenamento da matriz de map. Consulte a seção Comentários para obter mais informações.

pcMap
[out] O número dos valores COR_IL_MAP gravados na matriz de mapa.

mapa
[out] Uma matriz de valores do COR_IL_MAP que fornece informações sobre mapeamentos da IL instrumentada pelo criador de perfis para a IL do método original.

Comentários

Se o criador de perfil definir o mapeamento chamando o método ICorProfilerInfo::SetILInstrumentedCodeMap, o depurador poderá chamar esse método para recuperar o mapeamento e para usar o mapeamento internamente ao calcular deslocamentos da IL para rastreamentos de pilha e tempos de vida.

Se cMap for 0 e pcMap for não nulo, pcMap será definido para o número dos valores COR_IL_MAP disponíveis. Se cMap for não zero, representará a capacidade de armazenamento da matriz do map. Quando o método retorna, map contém um máximo de itenscMap e pcMap é definido para o número de valores COR_IL_MAP realmente gravados na matriz map.

Se a IL não tiver sido instrumentada ou o mapeamento não tiver sido fornecido por um criador de perfil, esse método retorna S_OK e define pcMap para 0.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4.5.2

Confira também