Add process discovery helpers and Magic facade accessors
Introduces ApplicationFinder (by name/title/handle), Magic.Open overloads, and Magic.Threads/Regions/QueryRegion accessors. Closes section 3 of add-thread-region-finder and updates tasks/comparison doc.
This commit is contained in:
+48
-1
@@ -1,7 +1,12 @@
|
||||
using System.Collections.Generic;
|
||||
using System.Diagnostics;
|
||||
using Process = System.Diagnostics.Process;
|
||||
using WhiteMagic.Execution;
|
||||
using WhiteMagic.Hooking;
|
||||
using WhiteMagic.Memory;
|
||||
using WhiteMagic.ProcessDiscovery;
|
||||
using WhiteMagic.Thread;
|
||||
using WhiteMagic.Windows;
|
||||
|
||||
namespace WhiteMagic;
|
||||
|
||||
@@ -24,6 +29,21 @@ public sealed class Magic : IDisposable
|
||||
/// <summary>Inline-detour manager (in-process only).</summary>
|
||||
public DetourManager DetourManager => Memory.DetourManager;
|
||||
|
||||
/// <summary>
|
||||
/// Returns the memory region that contains <paramref name="address"/>.
|
||||
/// </summary>
|
||||
public MemoryRegion QueryRegion(IntPtr address) => Memory.QueryRegion(address);
|
||||
|
||||
/// <summary>
|
||||
/// Enumerates the committed and reserved regions of the target process address space.
|
||||
/// </summary>
|
||||
public IEnumerable<MemoryRegion> Regions => Memory.EnumerateRegions();
|
||||
|
||||
/// <summary>
|
||||
/// Factory for discovering and operating on the target process's threads.
|
||||
/// </summary>
|
||||
public ThreadFactory Threads => new ThreadFactory(Memory);
|
||||
|
||||
private Magic(MemoryBase memory)
|
||||
{
|
||||
Memory = memory;
|
||||
@@ -31,11 +51,38 @@ public sealed class Magic : IDisposable
|
||||
}
|
||||
|
||||
/// <summary>Opens an external process for reading, writing, and execution.</summary>
|
||||
public static Magic Open(System.Diagnostics.Process process)
|
||||
public static Magic Open(Process process)
|
||||
{
|
||||
return new Magic(new ExternalReader(process));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Opens a target process by its image name. Throws if zero or more than one match.
|
||||
/// </summary>
|
||||
public static Magic Open(string processName)
|
||||
{
|
||||
using Process process = ApplicationFinder.OpenProcess(processName);
|
||||
return Open(process);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Opens the process that owns the top-level window with the specified title.
|
||||
/// </summary>
|
||||
public static Magic OpenByWindowTitle(string title)
|
||||
{
|
||||
using Process process = ApplicationFinder.OpenByWindowTitle(title);
|
||||
return Open(process);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Opens the process that owns the specified window handle.
|
||||
/// </summary>
|
||||
public static Magic OpenByWindowHandle(IntPtr handle)
|
||||
{
|
||||
using Process process = ApplicationFinder.OpenByWindowHandle(handle);
|
||||
return Open(process);
|
||||
}
|
||||
|
||||
/// <summary>Creates an in-process session for the current process.</summary>
|
||||
public static Magic OpenInProcess()
|
||||
{
|
||||
|
||||
Reference in New Issue
Block a user