"Step over" when debugging multithreaded programs in Visual Studio "Step over" when debugging multithreaded programs in Visual Studio multithreading multithreading

"Step over" when debugging multithreaded programs in Visual Studio


I think there is only one answer to your question, which you have discounted as being 'way too much work.' However, I believe that is because you are going about it the wrong way. Let me present steps for adding a conditional breakpoint on Thread ID, which are extremely easy, but not obvious until you know them.

  1. Stop the debugger at a point where you are in the correct thread you want to continue debugging in (which I would guess is usually the first thread that gets there).

  2. Enter $TID into the watch window.

  3. Add a break point with the condition $TID == <value of $TID from Watch Window>,
    Example: $TID == 0x000016a0

  4. Continue Execution.

$TID is a magic variable for Microsoft compilers (since at least Visual Studio 2003) that has the value of the current Thread ID. It makes it much easier than looking at (FS+0x18)[0x24]. =D

That being said, you can get the same behavior as the debugger's One-Shot breakpoints with some simple macros. When you step over, the debugger, behind the scenes, sets a breakpoint, runs to that breakpoint and then removes it. The key to a consistent user interface is removing those breakpoints if ANY breakpoint is hit.

The following two macros provide Step Over and Run To Cursor for the current thread. This is accomplished in the same manner as the debugger, with the breakpoints being removed after execution, regardless of which breakpoint is hit.

You will want to assign a key combination to run them.

NOTE: One caveat -- The Step Over macro only works correctly if the cursor is on the line you want to step over. This is because it determines the current location by the cursor location, and simply adds one to the line number. You may be able to replace the location calculation with information on the current execution point, though I was unable to locate that information from the Macro IDE.

Here they are and good luck bug hunting!!

To use these macros in Visual Studio:
1. Open the Macro IDE ( from the Menu, select: Tools->Macros->Macro IDE... )
2. Add a new Code File ( from the Menu: select: Project->Add New Item..., choose Code File, and click Add )
3. Paste in this code.
4. Save the file.

To add key combinations for running these macros in Visual Studio:
1. Open Options (from the Menu, select: Tools->Options )
2. Expand to Environment->Keyboard
3. In Show commands containing:, type Macros. to see all your macros.
4. Select a macro, then click in Press shortcut keys:
5. Type the combo you want to use (backspace deletes typed combos)
6. click Assign to set your shortcut to run the selected macro.

Imports SystemImports EnvDTEImports EnvDTE80Imports System.DiagnosticsPublic Module DebugHelperFunctions    Sub RunToCursorInMyThread()        Dim textSelection As EnvDTE.TextSelection        Dim myThread As EnvDTE.Thread        Dim bp As EnvDTE.Breakpoint        Dim bps As EnvDTE.Breakpoints        ' For Breakpoints.Add()        Dim FileName As String        Dim LineNumber As Integer        Dim ThreadID As String        ' Get local references for ease of use         myThread = DTE.Debugger.CurrentThread        textSelection = DTE.ActiveDocument.Selection        LineNumber = textSelection.ActivePoint.Line        FileName = textSelection.DTE.ActiveDocument.FullName        ThreadID = myThread.ID        ' Add a "One-Shot" Breakpoint in current file on current line for current thread        bps = DTE.Debugger.Breakpoints.Add("", FileName, LineNumber, 1, "$TID == " & ThreadID)        ' Run to the next stop        DTE.Debugger.Go(True)        ' Remove our "One-Shot" Breakpoint        For Each bp In bps            bp.Delete()        Next    End Sub    Sub StepOverInMyThread()        Dim textSelection As EnvDTE.TextSelection        Dim myThread As EnvDTE.Thread        Dim bp As EnvDTE.Breakpoint        Dim bps As EnvDTE.Breakpoints        ' For Breakpoints.Add()        Dim FileName As String        Dim LineNumber As Integer        Dim ThreadID As String        ' Get local references for ease of use         myThread = DTE.Debugger.CurrentThread        textSelection = DTE.ActiveDocument.Selection        LineNumber = textSelection.ActivePoint.Line        FileName = textSelection.DTE.ActiveDocument.FullName        ThreadID = myThread.ID        LineNumber = LineNumber + 1        ' Add a "One-Shot" Breakpoint in current file on current line for current thread        bps = DTE.Debugger.Breakpoints.Add("", FileName, LineNumber, 1, "$TID == " & ThreadID)        ' Run to the next stop        DTE.Debugger.Go(True)        ' Remove our "One-Shot" Breakpoint        For Each bp In bps            bp.Delete()        Next    End SubEnd Module

Disclaimer: I wrote these macros in Visual Studio 2005. You can probably use them fine in Visual Studio 2008. They may require modification for Visual Studio 2003 and before.


You can freeze a different thread or switch to another thread using the Threads debug window (Ctrl + Alt + H).


The simple way to debug one particular thread is to freeze all other threads from the Threads window.