ShuriZma
/
Cxbx-Reloaded
mirror of https://github.com/Cxbx-Reloaded/Cxbx-Reloaded.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Formatting

Margen67 2021-06-11 13:12:25 -10:00
parent 0e0ce8bfaa
commit da1d976f8b
1 changed files with 2 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Child-Process-Debugging.md

@ -1,6 +1,5 @@
# Child Process Debugging
Cxbx is currently engineering a way to run a new instance of itself as a child process.
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](https://marketplace.visualstudio.com/items?itemName=GreggMiskelly.MicrosoftChildProcessDebuggingPowerTool) to support child process debugging from within Visual Studio.
@ -9,9 +8,7 @@ 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`
@ -22,7 +19,6 @@ Install the extensions. You will need to close down any open Visual Studio insta
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`)
@ -31,13 +27,11 @@ The emulated process will have two threads named **Cxbx NV2A VBLANK**, and **Cxb
## 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`
@ -46,4 +40,4 @@ With the Child Process extension, you will need to:
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.
You only need to do this once.