C# Класс VSNDK.DebugEngine.AD7Engine

Constructor.

Add threads for a program when lauching it and the debugger (IDebugEngineLaunch2.LaunchSuspended).

Attaches to the program. Not implemented. (http://msdn.microsoft.com/en-us/library/bb161973.aspx)

Determines if a debug engine (DE) can detach from the program. (http://msdn.microsoft.com/en-us/library/bb161967.aspx)

Requests that the program stop execution the next time one of its threads attempts to run. The debugger calls CauseBreak when the user clicks on the pause button in VS. The debugger should respond by entering breakmode. (http://msdn.microsoft.com/en-us/library/bb145018.aspx)

Continues running this program from a stopped state. Any previous execution state (such as a step) is preserved, and the program starts executing again. (http://msdn.microsoft.com/en-us/library/bb162148.aspx)

Detaches a debug engine from the program. (http://msdn.microsoft.com/en-us/library/bb146228.aspx)

Retrieves a list of the code contexts for a given position in a source file. Not implemented. (http://msdn.microsoft.com/en-us/library/bb145902.aspx)

Retrieves a list of the code paths for a given position in a source file. EnumCodePaths is used for the step-into specific feature -- right click on the current statement and decide which function to step into. This is not something that the VSNDK debug engine supports. (http://msdn.microsoft.com/en-us/library/bb162326.aspx)

Retrieves a list of the modules that this program has loaded and is executing. (http://msdn.microsoft.com/en-us/library/bb146980.aspx)

Retrieves a list of the threads that are running in the program. (http://msdn.microsoft.com/en-us/library/bb145110.aspx)

TODO: Verify if this method is called or not by VS. Continues running this program from a stopped state. Any previous execution state (such as a step) is cleared, and the program starts executing again. (http://msdn.microsoft.com/en-us/library/bb162315.aspx)

Executes the debugger program. The thread is returned to give the debugger information on which thread the user is viewing when executing the program. ExecuteOnThread is called when the SDM wants execution to continue and have stepping state cleared. (http://msdn.microsoft.com/en-us/library/bb145596.aspx)

Gets the program's properties. The VSNDK debug engine does not support this. (http://msdn.microsoft.com/en-us/library/bb161801.aspx)

Gets the disassembly stream for this program or a part of this program. The sample engine does not support dissassembly so it returns E_NOTIMPL

This method gets the Edit and Continue (ENC) update for this program. A custom debug engine always returns E_NOTIMPL

Gets the name and GUID of the debug engine running this program. (http://msdn.microsoft.com/en-us/library/bb145854.aspx)

Get the list of threads being debugged, also returning the index of the current thread (or -1 in case of error)

Retrieves the memory bytes occupied by the program. Not implemented. (http://msdn.microsoft.com/en-us/library/bb145291.aspx)

Gets the name of the program. The name returned by this method is always a friendly, user-displayable name that describes the program. (http://msdn.microsoft.com/en-us/library/bb161279.aspx)

Get the process that this program is running in. Not implemented. (http://msdn.microsoft.com/en-us/library/bb145293.aspx)

Gets a GUID for this program. A debug engine (DE) must return the program identifier originally passed to the IDebugProgramNodeAttach2::OnAttach or IDebugEngine2::Attach methods. This allows identification of the program across debugger components. (http://msdn.microsoft.com/en-us/library/bb145581.aspx)

The SDM will call this method on the debug engine when it is created, to notify it of the user's symbol settings in Tools->Options->Debugging->Symbols. (http://msdn.microsoft.com/en-us/library/microsoft.visualstudio.debugger.interop.idebugsymbolsettings100.setsymbolloadstate.aspx)

Performs a step. This method is deprecated. Use the IDebugProcess3::Step method instead. (http://msdn.microsoft.com/en-us/library/bb162134.aspx)

Stops all threads running in this program. This method is called when this program is being debugged in a multi-program environment. When a stopping event from some other program is received, this method is called on this program. The implementation of this method should be asynchronous; that is, not all threads should be required to be stopped before this method returns. The implementation of this method may be as simple as calling the IDebugProgram2::CauseBreak method on this program. Not implemented. (http://msdn.microsoft.com/en-us/library/bb146567.aspx) The VSNDK debug engine only supports debugging native applications and therefore only has one program per-process

Terminates the program. (http://msdn.microsoft.com/en-us/library/bb145919.aspx)

Update the list of threads. This operation must be performed whenever the list of threads changes (a thread exits or is created) and before entering in break mode.

Allows (or disallows) expression evaluation to occur on the given thread, even if the program has stopped. WatchForExpressionEvaluationOnThread is used to cooperate between two different engines debugging the same process. The VSNDK debug engine doesn't cooperate with other engines, so it has nothing to do here. (http://msdn.microsoft.com/en-us/library/bb144913.aspx)

Watches for execution (or stops watching for execution) to occur on the given thread. WatchForThreadStep is used to cooperate between two different engines debugging the same process. The VSNDK debug engine doesn't cooperate with other engines, so it has nothing to do here. (http://msdn.microsoft.com/en-us/library/bb161406.aspx)

Writes a dump to a file. Not implemented. (http://msdn.microsoft.com/en-us/library/bb145827.aspx)

Clean the "flags" data (_alreadyEvaluated) that are stored in each thread without resetting the stack frames. This operation must be done whenever the stack frames for a given thread have to be evaluated, like when the user changes the current frame or when he wants to investigate different threads in break mode, for example.

Returns the current thread.

Verify if the stack frame information specified by "flags" were already evaluated.

Reset stack frames for each thread. This operation must be performed before changing the state to break mode, like when a breakpoint is hit, for example.

Returns the thread data structure with a given ID.

Set a given thread as the current one.

Requests that all programs being debugged by this DE stop execution the next time one of their threads attempts to run. This is normally called in response to the user clicking on the pause button in the debugger. When the break is complete, an AsyncBreakComplete event will be sent back to the debugger. (http://msdn.microsoft.com/en-us/library/bb145141.aspx)

Removes the specified exception so it is no longer handled by the debug engine. The VSNDK debug engine does not support exceptions in the debuggee so this method is not actually implemented. (http://msdn.microsoft.com/en-us/library/bb161697.aspx)

Gets the GUID of the DE. (http://msdn.microsoft.com/en-us/library/bb145079.aspx)

Creates a pending breakpoint in the Debug Engine. A pending breakpoint is essentially a collection of all the information needed to bind a breakpoint to code. (http://msdn.microsoft.com/en-us/library/bb147033.aspx)

Called by the SDM to indicate that a synchronous debug event, previously sent by the DE to the SDM, was received and processed. The only event the VSNDK Debug Engine sends in this fashion is Program Destroy. It responds to that event by shutting down the engine. (http://msdn.microsoft.com/en-us/library/bb160915.aspx)

Informs a DE that the program specified has been atypically terminated and that the DE should clean up all references to the program and send a program destroy event. (http://msdn.microsoft.com/en-us/library/bb145073.aspx)

Attach the debug engine to a program. (http://msdn.microsoft.com/en-us/library/bb145136.aspx)

Retrieves a list of all programs being debugged by a debug engine (DE). Not implemented. (http://msdn.microsoft.com/en-us/library/bb146175.aspx)

Sets the registry root currently in use by the DE. Different installations of Visual Studio can change where their registry information is stored. This allows the debugger to tell the engine where that location is. (http://msdn.microsoft.com/en-us/library/bb161800.aspx)

A metric is a registry value used to change a debug engine's behavior or to advertise supported functionality. This method can forward the call to the appropriate form of the Debugging SDK Helpers function, SetMetric. (http://msdn.microsoft.com/en-us/library/bb161968.aspx)

Sets the locale of the DE. This method is called by the session debug manager (SDM) to propagate the locale settings of the IDE so that strings returned by the DE are properly localized. The sample engine is not localized so this is not implemented. (http://msdn.microsoft.com/en-us/library/bb161784.aspx)

Determines if a process can be terminated. (http://msdn.microsoft.com/en-us/library/bb146673.aspx)

Launches a process by means of the debug engine. (http://msdn.microsoft.com/en-us/library/bb146223.aspx)