Delen via

Methode ICorProfilerInfo::GetILToNativeMapping

  • Artikel

Hiermee haalt u een kaart op van CIL-offsets (Common Intermediate Language) naar systeemeigen offsets voor de code in de opgegeven functie.

Syntaxis

HRESULT GetILToNativeMapping(
    [in] FunctionID functionId,
    [in] ULONG32 cMap,
    [out] ULONG32 *pcMap,
    [out, size_is(cMap), length_is(*pcMap)]
        COR_DEBUG_IL_TO_NATIVE_MAP map[]);

Parameters

functionId [in] De id van de functie die de code bevat.

cMap [in] De maximale grootte van de map matrix.

pcMap [uit] Het totale aantal beschikbare COR_DEBUG_IL_TO_NATIVE_MAP structuren.

map [uit] Een matrix van COR_DEBUG_IL_TO_NATIVE_MAP structuren, die elk de verschuivingen specificeert. Nadat de GetILToNativeMapping methode is geretourneerd, map bevat dit enkele of alle COR_DEBUG_IL_TO_NATIVE_MAP structuren.

Opmerkingen

De GetILToNativeMapping methode retourneert een matrix met COR_DEBUG_IL_TO_NATIVE_MAP structuren. Om aan te geven dat bepaalde bereiken van systeemeigen instructies overeenkomen met speciale coderegio's (bijvoorbeeld het prolog), kan een vermelding in de matrix het veld laten ilOffset instellen op een waarde van de opsomming CorDebugIlToNativeMappingTypes .

Nadat GetILToNativeMapping de buffer is geretourneerd, moet u controleren of de map buffer groot genoeg was om alle COR_DEBUG_IL_TO_NATIVE_MAP structuren te bevatten. Hiervoor vergelijkt u de waarde met cMap de waarde van de pcMap parameter. Als de waarde, wanneer deze pcMap wordt vermenigvuldigd met de grootte van een COR_DEBUG_IL_TO_NATIVE_MAP structuur, groter is dan cMap, een grotere map buffer toewijst, bijwerkt cMap met de nieuwe, grotere grootte en opnieuw aanroept GetILToNativeMapping .

U kunt ook eerst bellen GetILToNativeMapping met een buffer met lengte nul map om de juiste buffergrootte te verkrijgen. Vervolgens kunt u de buffergrootte instellen op de waarde die wordt pcMap geretourneerd en opnieuw aanroepen GetILToNativeMapping .

Vereisten

Platformen: Zie Systeemvereisten.

Koptekst: CorProf.idl, CorProf.h

Bibliotheek: CorGuids.lib

.NET Framework-versies: beschikbaar sinds 2.0

Zie ook