ICorDebugILFrame, interface

Article
08/22/2008

Mise à jour : novembre 2007

Représente un frame de pile de code MSIL (Microsoft Intermediate Language).

interface ICorDebugILFrame : ICorDebugFrame {
        
    typedef enum CorDebugMappingResult {
        MAPPING_PROLOG              = 0x1,
        MAPPING_EPILOG              = 0x2,
        MAPPING_NO_INFO             = 0x4,
        MAPPING_UNMAPPED_ADDRESS    = 0x8,
        MAPPING_EXACT               = 0x10,
        MAPPING_APPROXIMATE         = 0x20,
    } CorDebugMappingResult;
        
    HRESULT CanSetIP (
        [in] ULONG32                nOffset
    );
        
    HRESULT EnumerateArguments (
        [out] ICorDebugValueEnum    **ppValueEnum
    );
        
    HRESULT EnumerateLocalVariables( 
        [out] ICorDebugValueEnum    **ppValueEnum
    );
        
    HRESULT GetArgument (
        [in] DWORD                  dwIndex,
        [out] ICorDebugValue        **ppValue
    );
        
    HRESULT GetIP (
        [out] ULONG32               *pnOffset, 
        [out] CorDebugMappingResult *pMappingResult
    );
        
    HRESULT GetLocalVariable (
        [in] DWORD                  dwIndex,
        [out] ICorDebugValue        **ppValue
    );
        
    HRESULT GetStackDepth (
        [out] ULONG32               *pDepth
    );
        
    HRESULT GetStackValue (
        [in] DWORD                  dwIndex,
        [out] ICorDebugValue        **ppValue
    );
        
    HRESULT SetIP (
        [in] ULONG32                nOffset
    );
        
};

Méthodes

Méthode	Description
ICorDebugILFrame::CanSetIP, méthode	Obtient une valeur qui indique si l'affectation de l'emplacement d'offset spécifié au pointeur d'instruction présente un risque.
ICorDebugILFrame::EnumerateArguments, méthode	Obtient un énumérateur pour les arguments dans ce frame.
ICorDebugILFrame::EnumerateLocalVariables, méthode	Obtient un énumérateur pour les variables locales dans ce frame.
ICorDebugILFrame::GetArgument, méthode	Obtient la valeur de l'argument spécifié dans ce frame de pile MSIL.
ICorDebugILFrame::GetIP, méthode	Obtient la valeur du pointeur d'instruction et une valeur de combinaison d'opérations de bits qui décrivent comment la valeur du pointeur d'instruction a été obtenue.
ICorDebugILFrame::GetLocalVariable, méthode	Obtient la valeur de la variable locale spécifiée dans ce frame de pile MSIL.
ICorDebugILFrame::GetStackDepth, méthode	Pas implémenté.
ICorDebugILFrame::GetStackValue, méthode	Pas implémenté.
ICorDebugILFrame::SetIP, méthode	Définit le pointeur d'instruction à l'emplacement d'offset spécifié dans le code MSIL.

Notes

L'interface ICorDebugILFrame est une interface ICorDebugFrame spécialisée. Elle est utilisée pour les frames de code MSIL ou les frames compilés juste-à-temps (JIT, Just-In-Time). Les frames compilés JIT implémentent à la fois l'interface ICorDebugILFrame et l'interface ICorDebugNativeFrame.