Share via


Sending Startup Events After a Launch

Once the debug engine (DE) is attached to the program, it sends a series of startup events back to the debug session.

Startup events sent back to the debug session include the following:

  • An engine creation event.

  • A program creation event.

  • Thread creation and module load events.

  • A load complete event, sent when the code is loaded and ready to run, but before any code is executed

    Note

    When this event is continued, global variables are initialized and startup routines run.

  • Possible other thread creation and module load events.

  • An entry point event, which signals that the program has reached its main entry point, such as Main or WinMain. This event is not typically sent if the DE attaches to a program that is already running.

Programmatically, the DE first sends the session debug manager (SDM) an IDebugEngineCreateEvent2 interface, which represents an engine creation event, followed by an IDebugProgramCreateEvent2, which represents a program creation event.

This is typically followed by one or more IDebugThreadCreateEvent2 thread creation events and IDebugModuleLoadEvent2 module load events.

When the code is loaded and ready to run, but before any code is executed, the DE sends the SDM an IDebugLoadCompleteEvent2 load complete event. Finally, if the program is not already running, the DE sends an IDebugEntryPointEvent2 entry point event, signaling that the program has reached its main entry point and is ready for debugging.

See Also

Concepts

Control of Execution

Debugging Tasks