ShuriZma
/
Cxbx-Reloaded
mirror of https://github.com/Cxbx-Reloaded/Cxbx-Reloaded.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Page: Child Process Debugging
Pages
Child Process Debugging Cxbx Reloaded overview Developer notes Developing Homebrew and test programs Frequently Asked Questions (FAQ) HLE v2 Database Method Home Maintaining OOVPAs for HLE function detection OOVPA sorting Overview of the project & Glossary of terms Rebase Line Ending Fix Shortcut Keys Updating a sub moduled Git repository Xbox D3D drawing via NV2A Kelvin dgVoodoo Upscale Method
3 Child Process Debugging
Margen67 edited this page 2021-06-11 13:12:25 -10:00
Table of Contents

Child Process Debugging

Cxbx-Reloaded is currently engineering a way to run a new instance of itself as a child process.

For development, it is strongly recommended you install Microsoft Child Process Debugging Power Tool to support child process debugging from within Visual Studio.

Once setup, the extension attaches automatically.

It supports all the standard IDE features but will not detect symbols inside XBE memory regions, instead mapping to the virtual_memory_placeholder placeholder stub. You will still see callstacks, though.

Setup

Install the extensions. You will need to close down any open Visual Studio instances first.

  1. Open the Cxbx-Reloaded project file
  2. Open the new configuration window from Debug -> Other Debug Targets -> Child Process Debugging Settings
  3. From here, check Enable child process debugging
  4. In the table, double-click to add a new row, and enter Cxbx.exe as the process name
  5. Leave Action as Attach Debugger and Debugger Type as <Inherit from parent process>
  6. Make sure Persist settings to is set to Hidden solution user options file (SUO file) and hit Save (top right)

You only need to do this once.

Usage

Once emulation has started, Visual Studio will list two Cxbx.exe processes on the toolbar

You can reshow this toolbar by checking View -> Toolbars -> Debug Location)

The emulated process will have two threads named Cxbx NV2A VBLANK, and Cxbx NV2A FIFO.

Cxbx Debugger Workflow

The Cxbx-Reloaded project includes a basic debugger written in C# to support extra Xbox-specific emulation features in addition to debugging the child process.

Only one user-mode debugger can be attached to a process at one time.

With the Child Process extension, you will need to:

  1. Open the Cxbx-Reloaded project file
  2. Open the new configuration window from Debug -> Other Debug Targets -> Child Process Debugging Settings
  3. From here, disable Child Process Debugging on Cxbx.exe
  4. In the table, double-click to add a new row, and enter CxbxDebugger.exe as the process name
  5. Leave Action as Attach Debugger
  6. Set Debugger Type as Managed (v4.6, v4.5, v4.0)
  7. Make sure Persist settings to is set to Hidden solution user options file (SUO file) and hit Save (top right)

You only need to do this once.

Home

Usage:

Development:

Other links: