task 1.4: add NativeMethods.cs LibraryImport P/Invoke surface

Add LibraryImport-based P/Invoke declarations for all required Win32 APIs: OpenProcess, CloseHandle, ReadProcessMemory, WriteProcessMemory, VirtualAllocEx, VirtualProtectEx, VirtualFreeEx, CreateRemoteThread, GetThreadContext, SetThreadContext, Wow64GetThreadContext, Wow64SetThreadContext, LoadLibrary, GetProcAddress, and WaitForSingleObject. Add InternalsVisibleTo WhiteMagicTest so the test project can call internal NativeMethods. Tests (NativeSurfaceTests): 7/7 passing.
2026-07-21 17:01:41 +02:00
parent eea175499d
commit 302da5f3c2
7 changed files with 630 additions and 1 deletions
@@ -0,0 +1,136 @@
+using System.Runtime.InteropServices;
+
+namespace WhiteMagic.Native;
+
+/// <summary>
+/// P/Invoke declarations for the Win32 process, memory, thread, and module
+/// APIs that WhiteMagic uses. Every declaration uses <see cref="LibraryImportAttribute"/>
+/// (source-generated interop). SetLastError is enabled on all calls that the
+/// Win32 API documents as setting a thread-local last-error value.
+/// </summary>
+internal static partial class NativeMethods
+{
+    // ── Process ──────────────────────────────────────────────────────────────
+
+    /// <summary>Opens an existing process and returns a handle to it.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    internal static partial SafeMemoryHandle OpenProcess(
+        ProcessAccess desiredAccess,
+        [MarshalAs(UnmanagedType.Bool)] bool inheritHandle,
+        int processId);
+
+    /// <summary>Closes an open object handle.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    internal static partial bool CloseHandle(IntPtr handle);
+
+    // ── Memory ───────────────────────────────────────────────────────────────
+
+    /// <summary>Reads memory from a process.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    internal static partial bool ReadProcessMemory(
+        SafeMemoryHandle process,
+        IntPtr baseAddress,
+        Span<byte> buffer,
+        int size,
+        out nint bytesRead);
+
+    /// <summary>Writes memory to a process.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    internal static partial bool WriteProcessMemory(
+        SafeMemoryHandle process,
+        IntPtr baseAddress,
+        ReadOnlySpan<byte> buffer,
+        int size,
+        out nint bytesWritten);
+
+    /// <summary>Reserves or commits a region of memory in a process.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    internal static partial IntPtr VirtualAllocEx(
+        SafeMemoryHandle process,
+        IntPtr address,
+        nint size,
+        MemoryAllocationType allocationType,
+        MemoryProtectionType protect);
+
+    /// <summary>Changes the protection on a committed region of memory.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    internal static partial bool VirtualProtectEx(
+        SafeMemoryHandle process,
+        IntPtr address,
+        nint size,
+        MemoryProtectionType newProtect,
+        out MemoryProtectionType oldProtect);
+
+    /// <summary>Releases or decommits a region of memory in a process.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    internal static partial bool VirtualFreeEx(
+        SafeMemoryHandle process,
+        IntPtr address,
+        nint size,
+        MemoryFreeType freeType);
+
+    // ── Threading ────────────────────────────────────────────────────────────
+
+    /// <summary>Creates a thread that runs in the virtual address space of a process.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    internal static partial SafeMemoryHandle CreateRemoteThread(
+        SafeMemoryHandle process,
+        IntPtr threadAttributes,
+        nint stackSize,
+        IntPtr startAddress,
+        IntPtr parameter,
+        ThreadCreationFlags creationFlags,
+        out int threadId);
+
+    /// <summary>Sets a 64-bit thread context (AMD64).</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    internal static partial bool SetThreadContext(
+        SafeMemoryHandle thread,
+        ref Context64 context);
+
+    /// <summary>Gets a 64-bit thread context (AMD64).</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    internal static partial bool GetThreadContext(
+        SafeMemoryHandle thread,
+        ref Context64 context);
+
+    /// <summary>Sets a 32-bit (WOW64) thread context.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    internal static partial bool Wow64SetThreadContext(
+        SafeMemoryHandle thread,
+        ref Context32 context);
+
+    /// <summary>Gets a 32-bit (WOW64) thread context.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    internal static partial bool Wow64GetThreadContext(
+        SafeMemoryHandle thread,
+        ref Context32 context);
+
+    // ── Modules ──────────────────────────────────────────────────────────────
+
+    /// <summary>Loads a module into the calling process.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true, EntryPoint = "LoadLibraryW")]
+    internal static partial IntPtr LoadLibrary(
+        [MarshalAs(UnmanagedType.LPWStr)] string lpFileName);
+
+    /// <summary>Returns the address of a function or variable from a loaded module.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    internal static partial IntPtr GetProcAddress(
+        IntPtr hModule,
+        [MarshalAs(UnmanagedType.LPStr)] string lpProcName);
+
+    /// <summary>Waits until a thread exits and retrieves its exit code.</summary>
+    [LibraryImport("kernel32.dll", SetLastError = true)]
+    internal static partial int WaitForSingleObject(
+        SafeMemoryHandle handle,
+        uint milliseconds);
+}