ICorProfilerInfo::GetILToNativeMapping (Método)

2011-08-10

Obtiene una asignación de desplazamientos del lenguaje intermedio de Microsoft (MSIL) a los desplazamientos nativos para el código incluido en la función especificada.

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[]);

Parámetros

functionId
[in] Id. de la función que contiene el código.
cMap
[in] Tamaño máximo de la matriz de map.
pcMap
[out] Número total de estructuras COR_DEBUG_IL_TO_NATIVE_MAP disponibles.
map
[out] Matriz de estructuras COR_DEBUG_IL_TO_NATIVE_MAP, cada una de las cuales especifica los desplazamientos. Después de que el método GetILToNativeMapping devuelva un resultado, map contendrá algunas o todas las estructuras COR_DEBUG_IL_TO_NATIVE_MAP.

Comentarios

El método GetILToNativeMapping devuelve una matriz de estructuras COR_DEBUG_IL_TO_NATIVE_MAP. Para indicar que algunos intervalos de instrucciones nativas se corresponden con regiones de código especiales (por ejemplo, el prólogo), es posible establecer el campo ilOffset de una entrada de la matriz en un valor de la enumeración CorDebugIlToNativeMappingTypes.

Después de que GetILToNativeMapping devuelva un resultado, debe comprobar que el búfer map era suficientemente grande para contener todas las estructuras COR_DEBUG_IL_TO_NATIVE_MAP. Para ello, compare el valor de cMap con el valor del parámetro pcMap. Si el valor de pcMap, al multiplicarlo por el tamaño de una estructura COR_DEBUG_IL_TO_NATIVE_MAP, es mayor que cMap, asigne un búfer de map mayor, actualice cMap con el nuevo tamaño superior y llame de nuevo a GetILToNativeMapping.

Otra opción es llamar primero a GetILToNativeMapping con un búfer de map de longitud cero para obtener el tamaño de búfer correcto. Después, puede establecer el tamaño del búfer en el valor devuelto en pcMap y llamar de nuevo a GetILToNativeMapping.

Para obtener más información sobre estos dos enfoques, vea Búferes asignados por el llamador.