ICorProfilerInfo3::GetFunctionEnter3Info, méthode

  • Article

Fournit des informations sur le frame de pile et l’argument de la fonction signalée au profileur par la fonction FunctionEnter3WithInfo. Cette méthode peut être appelée uniquement pendant le rappel de FunctionEnter3WithInfo.

Syntaxe

HRESULT GetFunctionEnter3Info(  
            [in]  FunctionID functionId,
            [in]  COR_PRF_ELT_INFO eltInfo,  
            [out] COR_PRF_FRAME_INFO *pFrameInfo,  
            [in, out] ULONG *pcbArgumentInfo,  
            [out, size_is(*pcbArgumentInfo)]  
                  COR_PRF_FUNCTION_ARGUMENT_INFO *pArgumentInfo);

Paramètres

functionId
[in] FunctionID de la fonction entrée.

eltInfo
[in] Handle opaque qui représente des informations sur un frame de pile donné. Le profileur doit fournir le même eltInfo que la fonction FunctionEnter3WithInfo.

pFrameInfo
[out] Handle opaque qui représente des informations génériques sur un frame de pile donné. Ce handle est uniquement valide pendant le rappel FunctionEnter3WithInfo au cours duquel le profileur a appelé la méthode GetFunctionEnter3Info.

pcbArgumentInfo
[in, out] Pointeur vers la taille totale, en octets, de la structure COR_PRF_FUNCTION_ARGUMENT_INFO (plus toute structure COR_PRF_FUNCTION_ARGUMENT_RANGE supplémentaire pour les plages d’arguments vers lesquelles pArgumentInfo pointe). Si la taille spécifiée est insuffisante, ERROR_INSUFFICIENT_BUFFER est retourné et la taille attendue est stockée dans pcbArgumentInfo. Pour appeler GetFunctionEnter3Info pour récupérer uniquement la valeur attendue pour *pcbArgumentInfo, affectez à *pcbArgumentInfo la valeur 0 et à pArgumentInfo la valeur NULL.

pArgumentInfo
[out] Pointeur vers une structure COR_PRF_FUNCTION_ARGUMENT_INFO qui décrit les emplacements des arguments de la fonction en mémoire, de gauche à droite.

Notes

Le profileur doit allouer suffisamment d'espace à la structure COR_PRF_FUNCTION_ARGUMENT_INFO de la fonction inspectée et indiquer la taille dans le paramètre pcbArgumentInfo.

Configuration requise

Plateformes : Consultez Configuration requise.

En-tête : CorProf.idl, CorProf.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 4

Voir aussi