minhook-detours-sys 0.1.2

Raw bindings to MinHook Detours, the MinHook API wrapping around KNSoft.SlimDetours.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

use minhook_detours_sys::*;

#[test]
fn simple_detour() {

    unsafe extern "system" fn add_two(lhs: i32, rhs: i32) -> i64 {
        (lhs + rhs) as i64
    }

    unsafe extern "system" fn add_two_hook(lhs: i32, rhs: i32) -> i64 {
        (lhs - rhs) as i64
    }

    let target = add_two as *mut std::ffi::c_void;
    let detour = add_two_hook as *mut std::ffi::c_void;
    let mut original = std::ptr::null_mut() as *mut std::ffi::c_void;

    unsafe {
        let status = MH_Initialize();
        assert_eq!(status, MH_OK);

        let status = MH_CreateHook(target, detour, &mut original);
        assert_eq!(status, MH_OK);
        assert_ne!(original, std::ptr::null_mut());

        let status = MH_EnableHook(target);
        assert_eq!(status, MH_OK);

        // If [`apply_two_hook`] is applied, then the function should turn to subtracting the 2 argument integers
        // `(lhs - rhs)`. Therefore, we expect the result to be `0` (`2 - 2 = 0`).
        let result = add_two(2, 2);
        assert_eq!(result, 0);

        let status = MH_DisableHook(target);
        assert_eq!(status, MH_OK);
        assert_eq!(add_two(2,2), 4);

        let status = MH_Uninitialize();
        assert_eq!(status, MH_OK);
    }
}