ICorDebugThread2::GetActiveFunctions, méthode

Article
08/10/2011

Obtient des informations sur la fonction active dans chacun des frames de ce thread.

HRESULT GetActiveFunctions (
    [in]   ULONG32             cFunctions,
    [out]  ULONG32             *pcFunctions,
    [in, out, size_is(cFunctions), length_is(*pcFunctions)]
        COR_ACTIVE_FUNCTION    pFunctions[]
);

Paramètres

cFunctions
[in] Taille du tableau pFunctions.
pcFunctions
[out] Pointeur vers le nombre d'objets retournés dans le tableau pFunctions. Le nombre d'objets retourné sera égal au nombre de frames managées sur la pile.
pFunctions
[in, out] Tableau d'objets COR_ACTIVE_FUNCTION, qui contiennent chacun des informations sur les fonctions actives dans les frames de ce thread.

Le premier élément sera utilisé pour la frame terminal, et ainsi de suite en remontant jusqu'à la racine de la pile.

Notes

Si pFunctions est null en entrée, GetActiveFunctions retourne uniquement le nombre de fonctions qui sont sur la pile. Autrement dit, Si pFunctions est nul sur en entrée, GetActiveFunctions retourne une valeur uniquement dans pcFunctions.

La méthode GetActiveFunctions se veut une optimisation par rapport à l'obtention des mêmes informations des frames dans une trace de la pile, et inclut uniquement les frames qui auraient eu un objet ICorDebugILFrame pour eux dans la trace de la pile complète.