Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ICorProfilerInfo2::GetFunctionInfo2 Method

Gets the parent class, the metadata token, and the ClassID of each type argument, if present, of a function.

HRESULT GetFunctionInfo2(
    [in]  FunctionID funcId,
    [in]  COR_PRF_FRAME_INFO frameInfo,
    [out] ClassID *pClassId,
    [out] ModuleID *pModuleId,
    [out] mdToken *pToken,
    [in]  ULONG32 cTypeArgs,
    [out] ULONG32 *pcTypeArgs,
    [out] ClassID typeArgs[]);
funcId

[in] The ID of the function for which to get the parent class and other information.

frameInfo

[in] A COR_PRF_FRAME_INFO value that points to information about a stack frame.

pClassId

[out] A pointer to the parent class of the function.

pModuleId

[out] A pointer to the module in which the function's parent class is defined.

pToken

[out] A pointer to the metadata token for the function.

cTypeArgs

[in] The size of the typeArgs array.

pcTypeArgs

[out] A pointer to the total number of ClassID values.

typeArgs

[out] An array of ClassID values, each of which is the ID of a type argument of the function. When the method returns, typeArgs will contain some or all of the ClassID values.

The profiler code can call ICorProfilerInfo::GetModuleMetaData to obtain a metadata interface for a given module. The metadata token that is returned to the location referenced by pToken can then be used to access the metadata for the function.

The class ID and type arguments that are returned through the pClassId and typeArgs parameters depend on the value that is passed in the frameInfo parameter, as shown in the following table.

Value of the frameInfo parameter

Result

A COR_PRF_FRAME_INFO value that was obtained from a FunctionEnter2 callback

The ClassID, returned in the location referenced by pClassId, and all type arguments, returned in the typeArgs array, will be exact.

A COR_PRF_FRAME_INFO that was obtained from a source other than a FunctionEnter2 callback

The exact ClassID and type arguments cannot be determined. That is, the ClassID might be null and some type arguments might come back as Object.

Zero

The exact ClassID and type arguments cannot be determined. That is, the ClassID might be null and some type arguments might come back as Object.

After GetFunctionInfo2 returns, you must verify that the typeArgs buffer was large enough to contain all the ClassID values. To do this, compare the value that pcTypeArgs points to with the value of the cTypeArgs parameter. If pcTypeArgs points to a value that is larger than cTypeArgs divided by the size of a ClassID value, allocate a larger pcTypeArgs buffer, update cTypeArgs with the new, larger size, and call GetFunctionInfo2 again.

Alternatively, you can first call GetFunctionInfo2 with a zero-length pcTypeArgs buffer to obtain the correct buffer size. You can then set the buffer size to the value returned in pcTypeArgs divided by the size of a ClassID value, and call GetFunctionInfo2 again.

For more information about these two approaches, see Profiling API Method Conventions.

Platforms: See .NET Framework System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.