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

8
Child-Process-Debugging.md

@ -1,6 +1,5 @@
# Child Process Debugging # Child Process Debugging
Cxbx-Reloaded is currently engineering a way to run a new instance of itself as a child process.
Cxbx 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. 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. 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 ## Setup
Install the extensions. You will need to close down any open Visual Studio instances first. Install the extensions. You will need to close down any open Visual Studio instances first.
1. Open the Cxbx-Reloaded project file 1. Open the Cxbx-Reloaded project file
2. Open the new configuration window from `Debug -> Other Debug Targets -> Child Process Debugging Settings` 2. Open the new configuration window from `Debug -> Other Debug Targets -> Child Process Debugging Settings`
3. From here, check `Enable child process debugging` 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. You only need to do this once.
## Usage ## Usage
Once emulation has started, Visual Studio will list two `Cxbx.exe` processes on the toolbar 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`) 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 ## 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. 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.** **Only one user-mode debugger can be attached to a process at one time.**
With the Child Process extension, you will need to: With the Child Process extension, you will need to:
1. Open the Cxbx-Reloaded project file 1. Open the Cxbx-Reloaded project file
2. Open the new configuration window from `Debug -> Other Debug Targets -> Child Process Debugging Settings` 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` 3. From here, disable Child Process Debugging on `Cxbx.exe`