ICorProfilerInfo2::GetCodeInfo2 (Método)

2011-08-10

Obtiene las extensiones del código nativo asociadas al FunctionID especificado.

HRESULT GetCodeInfo2(
    [in]  FunctionID functionID,
    [in]  ULONG32 cCodeInfos,
    [out] ULONG32 *pcCodeInfos,
    [out, size_is(cCodeInfos), length_is(*pcCodeInfos)]
    COR_PRF_CODE_INFO codeInfos[]);

Parámetros

functionID
[in] Id. de la función a la que está asociada el código nativo.
cCodeInfos
[in] Tamaño de la matriz de codeInfos.
pcCodeInfos
[out] Puntero al número total de estructuras COR_PRF_CODE_INFO disponibles.
codeInfos
[out] Búfer proporcionado por el llamador. Una vez que el método vuelva, contendrá una matriz de estructuras COR_PRF_CODE_INFO, cada una de las cuales describe un bloque de código nativo.

Comentarios

Las extensiones se clasifican por orden de desplazamiento de lenguaje intermedio de Microsoft (MSIL), de menor a mayor.

Cuando vuelva GetCodeInfo2, debe comprobar que el búfer codeInfos fuera suficientemente grande para contener todas las estructuras COR_PRF_CODE_INFO. Para ello, compare el valor de cCodeInfos con el valor del parámetro cchName. Si cCodeInfos dividido por el tamaño de una estructura COR_PRF_CODE_INFO es menor que pcCodeInfos, asigne un búfer codeInfos mayor, actualice cCodeInfos con el nuevo tamaño mayor y llame de nuevo a GetCodeInfo2.

También puede llamar primero a GetCodeInfo2 con un búfer codeInfos de longitud cero para obtener el tamaño de búfer correcto. A continuación, puede establecer el tamaño del búfer codeInfos en el valor devuelto en pcCodeInfos multiplicado por el tamaño de una estructura COR_PRF_CODE_INFO y llamar de nuevo a GetCodeInfo2.

Para obtener más información sobre estos dos enfoques, vea Convenciones de los métodos de la API de generación de perfiles.