# derdyast1r/eacbypass-cr3readydrv architecture

> Architecture diagram of the GitHub repository derdyast1r/eacbypass-cr3readydrv, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/derdyast1r/eacbypass-cr3readydrv
- Repository: https://github.com/derdyast1r/eacbypass-cr3readydrv

## Overview

The repository contains two related Windows kernel-driver approaches: a CR3-based request path with a small user-mode client, and a callback-based kernel communication path. The documented goal is driver-to-user-mode communication and process-memory operations, with callback/hooking support; the README explicitly says the setup is incomplete and lists CR3 read/write and other capabilities as work to add. The callback handler excerpts are partial, so unshown dispatch and helper relationships are omitted.

Main entry points: [`cr3 - Ioctl Driver/cr3 - Ioctl Driver/Kernel/DrvSrc.cpp`](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/cr3%20-%20Ioctl%20Driver/cr3%20-%20Ioctl%20Driver/Kernel/DrvSrc.cpp) (Hook Control), [`Cr3 Ready Driver/um/driver.hpp`](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/um/driver.hpp) (User Client), [`Cr3 Ready Driver/km/main.cpp`](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/km/main.cpp) (Driver Entry), [`Cr3 Ready Driver/km/utils.hpp`](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/km/utils.hpp) (CR3 Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cr3["CR3 Request Driver"]
  node_client["User Client<br/>[driver.hpp]"]
  node_entry["Driver Entry<br/>[main.cpp]"]
  node_cr3utils["CR3 Operations<br/>[utils.hpp]"]
end

subgraph group_callbacks["Callback Driver"]
  node_hookdriver["Hook Control<br/>[DrvSrc.cpp]"]
  node_callbackops["Memory Callbacks"]
  node_kernelutils["Kernel Utilities<br/>[Utility.cpp]"]
  node_utilityapi["Utility API<br/>[Utility.h]"]
end

subgraph group_shared["Protocol Definitions"]
  node_cr3defs["Request Types<br/>[defs.hpp]"]
  node_callbackprotocol["Callback Protocol<br/>[CallbackHandler.h]"]
end

node_external(("User Application"))
node_win32k["Windows win32k"]
node_peauth["PEAUTH Driver"]

node_external -->|"uses client"| node_client
node_client -.->|"sends request"| node_entry
node_client -->|"calls resolved function"| node_win32k
node_entry -->|"routes operations"| node_cr3utils
node_entry -->|"patches handler"| node_win32k
node_cr3utils -->|"uses definitions"| node_cr3defs
node_hookdriver -->|"hooks dispatch"| node_peauth
node_hookdriver -->|"dispatches callbacks"| node_callbackops
node_hookdriver -->|"uses request types"| node_callbackprotocol
node_callbackops -->|"uses physical helpers"| node_kernelutils
node_kernelutils -->|"implements declarations"| node_utilityapi

click node_client "https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/um/driver.hpp"
click node_entry "https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/km/main.cpp"
click node_cr3utils "https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/km/utils.hpp"
click node_cr3defs "https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/km/defs.hpp"
click node_hookdriver "https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/cr3%20-%20Ioctl%20Driver/cr3%20-%20Ioctl%20Driver/Kernel/DrvSrc.cpp"
click node_callbackops "https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/cr3%20-%20Ioctl%20Driver/cr3%20-%20Ioctl%20Driver/Usermode/CallbackHandler.cpp"
click node_callbackprotocol "https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/CallbackHandler.h"
click node_kernelutils "https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/cr3%20-%20Ioctl%20Driver/cr3%20-%20Ioctl%20Driver/Kernel/Utility.cpp"
click node_utilityapi "https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/cr3%20-%20Ioctl%20Driver/cr3%20-%20Ioctl%20Driver/Kernel/Utility.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client,node_entry,node_cr3utils,node_external toneBlue
class node_hookdriver,node_callbackops,node_kernelutils,node_utilityapi toneAmber
class node_cr3defs,node_callbackprotocol toneMint
class node_win32k,node_peauth toneIndigo
```

## Components

### CR3 Request Driver

- [User Client](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/um/driver.hpp): `Cr3 Ready Driver/um/driver.hpp`
- [Driver Entry](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/km/main.cpp): `Cr3 Ready Driver/km/main.cpp`
- [CR3 Operations](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/km/utils.hpp): `Cr3 Ready Driver/km/utils.hpp`

### Callback Driver

- [Hook Control](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/cr3%20-%20Ioctl%20Driver/cr3%20-%20Ioctl%20Driver/Kernel/DrvSrc.cpp): `cr3 - Ioctl Driver/cr3 - Ioctl Driver/Kernel/DrvSrc.cpp`
- [Memory Callbacks](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/cr3%20-%20Ioctl%20Driver/cr3%20-%20Ioctl%20Driver/Usermode/CallbackHandler.cpp): `cr3 - Ioctl Driver/cr3 - Ioctl Driver/Usermode/CallbackHandler.cpp`
- [Kernel Utilities](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/cr3%20-%20Ioctl%20Driver/cr3%20-%20Ioctl%20Driver/Kernel/Utility.cpp): `cr3 - Ioctl Driver/cr3 - Ioctl Driver/Kernel/Utility.cpp`
- [Utility API](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/cr3%20-%20Ioctl%20Driver/cr3%20-%20Ioctl%20Driver/Kernel/Utility.h): `cr3 - Ioctl Driver/cr3 - Ioctl Driver/Kernel/Utility.h`

### Protocol Definitions

- [Request Types](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/Cr3%20Ready%20Driver/km/defs.hpp): `Cr3 Ready Driver/km/defs.hpp`
- [Callback Protocol](https://github.com/derdyast1r/eacbypass-cr3readydrv/blob/main/CallbackHandler.h): `CallbackHandler.h`

### Other components

- **User Application**
- **Windows win32k**
- **PEAUTH Driver**

## Connections

- User Application → User Client: uses client (evidence: `Cr3 Ready Driver/um/driver.hpp`)
- User Client → Driver Entry: sends request
- User Client → Windows win32k: calls resolved function (evidence: `Cr3 Ready Driver/um/driver.hpp`)
- Driver Entry → CR3 Operations: routes operations (evidence: `Cr3 Ready Driver/km/main.cpp`)
- Driver Entry → Windows win32k: patches handler (evidence: `Cr3 Ready Driver/km/main.cpp`)
- CR3 Operations → Request Types: uses definitions (evidence: `Cr3 Ready Driver/km/utils.hpp`)
- Hook Control → PEAUTH Driver: hooks dispatch (evidence: `cr3 - Ioctl Driver/cr3 - Ioctl Driver/Kernel/DrvSrc.cpp`)
- Hook Control → Memory Callbacks: dispatches callbacks (evidence: `cr3 - Ioctl Driver/cr3 - Ioctl Driver/Kernel/DrvSrc.cpp`)
- Hook Control → Callback Protocol: uses request types (evidence: `cr3 - Ioctl Driver/cr3 - Ioctl Driver/Kernel/DrvSrc.cpp`)
- Memory Callbacks → Kernel Utilities: uses physical helpers (evidence: `cr3 - Ioctl Driver/cr3 - Ioctl Driver/Usermode/CallbackHandler.cpp`)
- Kernel Utilities → Utility API: implements declarations (evidence: `cr3 - Ioctl Driver/cr3 - Ioctl Driver/Kernel/Utility.cpp`)
