ICorDebugILCode2::GetInstrumentedILMap, méthodeICorDebugILCode2::GetInstrumentedILMap Method

[Pris en charge dans .NET Framework 4.5.2 et ultérieur][Supported in the .NET Framework 4.5.2 and later versions]

Retourne un mappage des décalages du langage intermédiaire instrumenté par le profileur avec les décalages du langage intermédiaire de la méthode d'origine pour cette instance.Returns a map from profiler-instrumented intermediate language (IL) offsets to original method IL offsets for this instance.

SyntaxeSyntax

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

ParamètresParameters

cMapcMap
[en entrée] La capacité de stockage du tableau map.[in] The storage capacity of the map array. Pour plus d'informations, consultez la section Notes.See the Remarks section for more information.

pcMappcMap
[out] Le nombre de valeurs COR_IL_MAP écrites dans le tableau de mappage.[out] The number of COR_IL_MAP values written to the map array.

mapmap
[out] Un tableau de valeurs COR_IL_MAP qui fournissent des informations sur les mappages de langage intermédiaire instrumenté du profileur pour le langage intermédiaire de la méthode d’origine.[out] An array of COR_IL_MAP values that provide information on mappings from profiler-instrumented IL to the IL of the original method.

NotesRemarks

Si le profileur définit le mappage en appelant le ICorProfilerInfo::SetILInstrumentedCodeMap (méthode), le débogueur peut appeler cette méthode pour récupérer le mappage et d’utiliser le mappage en interne lors du calcul de langage intermédiaire des décalages de pile les traces et les durées de vie des variables.If the profiler sets the mapping by calling the ICorProfilerInfo::SetILInstrumentedCodeMap method, the debugger can call this method to retrieve the mapping and to use the mapping internally when calculating IL offsets for stack traces and variable lifetimes.

Si cMap est égal à 0 et pcMap est non -null, pcMap est défini sur le nombre de valeurs COR_IL_MAP disponibles.If cMap is 0 and pcMap is non-null, pcMap is set to the number of available COR_IL_MAP values. Si cMap est différent de zéro, il représente la capacité de stockage du tableau map.If cMap is non-zero, it represents the storage capacity of the map array. Lorsque la méthode est retournée, map contient un maximum de cMap éléments, et pcMap est défini sur le nombre de valeurs COR_IL_MAP réellement écrits dans le map tableau.When the method returns, map contains a maximum of cMap items, and pcMap is set to the number of COR_IL_MAP values actually written to the map array.

Si le langage intermédiaire n'a pas été instrumenté ou si le mappage n'a pas été fourni par le profileur, cette méthode retourne S_OK et définit pcMap à 0.If the IL hasn't been instrumented or the mapping wasn't provided by a profiler, this method returns S_OK and sets pcMap to 0.

Configuration requiseRequirements

Plateformes : Consultez Configuration requise.Platforms: See System Requirements.

En-tête : CorDebug.idl, CorDebug.hHeader: CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.libLibrary: CorGuids.lib

Versions du .NET Framework : Disponible à partir de 4.5.2Available since 4.5.2.NET Framework Versions: Disponible à partir de 4.5.2Available since 4.5.2

Voir aussiSee also