min_hook_rs 1.3.0

A Rust implementation of MinHook library for Windows x64 function hooking with enhanced precision instruction decoding
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

//! # MinHook-rs
//!
//! A Rust implementation of MinHook library for Windows x64 function hooking.
//!
//! ## Documentation
//!
//! For complete documentation, examples, and technical details, see the [README.md](https://github.com/Rukkhadevata123/min_hook_rs/blob/main/README.md).
//!
//! ## Quick Example
//!
//! ```rust,no_run
//! use min_hook_rs::*;
//! use std::ffi::c_void;
//!
//! unsafe extern "system" fn my_hook() -> i32 { 42 }
//!
//! fn main() -> Result<()> {
//!     initialize()?;
//!     let trampoline = create_hook(0x12345678 as *mut c_void, my_hook as *mut c_void)?;
//!     enable_hook(0x12345678 as *mut c_void)?;
//!     // Function is now hooked
//!     Ok(())
//! }
//! ```

#[cfg(not(target_arch = "x86_64"))]
compile_error!("This crate only supports x86_64 architecture");

#[cfg(not(target_os = "windows"))]
compile_error!("This crate only supports Windows");

pub mod buffer;
pub mod disasm;
pub mod error;
pub mod hook;
pub mod instruction;
pub mod trampoline;

// Re-export main API
pub use error::{HookError, Result};
pub use hook::{
    ALL_HOOKS, apply_queued, create_hook, create_hook_api, create_hook_api_ex, disable_hook,
    enable_hook, initialize, queue_disable_hook, queue_enable_hook, remove_hook, status_to_string,
    uninitialize,
};

// Re-export for advanced usage
pub use disasm::{HookInstruction, can_hook_safely, decode_instruction};

/// Library version
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

/// Check if the current platform is supported
pub fn is_supported() -> bool {
    cfg!(target_arch = "x86_64") && cfg!(target_os = "windows")
}

/// Get library version string
pub fn get_version() -> &'static str {
    VERSION
}