Struct StaticHook 

pub struct StaticHook<F> { /* private fields */ }

Implementations

impl<F: Copy> StaticHook<F>

pub const fn new() -> Self

Examples found in repository

examples/static_hook_basic.rs (line 10)

static HOOK: StaticHook<fn(i32) -> i32> = StaticHook::new();

pub fn set_before<C: Fn() + Send + Sync + 'static>(&self, cb: C)

Examples found in repository

examples/static_hook_basic.rs (line 34)

fn main() -> dobby_rs_framework::Result<()> {
    common::init_example_logging();

    // EN: Set optional callbacks (not required).
    // CN: 设置可选回调（非必须）。
    HOOK.set_before(|| log::info!("before"));
    HOOK.set_after(|| log::info!("after"));

    unsafe {
        HOOK.install(
            common::target_add as fn(i32) -> i32,
            detour_add as fn(i32) -> i32,
        )?;
    }

    let v = common::target_add(1);
    println!("target_add(1) = {v}");

    unsafe {
        HOOK.uninstall()?;
    }
    Ok(())
}

pub fn set_after<C: Fn() + Send + Sync + 'static>(&self, cb: C)

Examples found in repository

examples/static_hook_basic.rs (line 35)

fn main() -> dobby_rs_framework::Result<()> {
    common::init_example_logging();

    // EN: Set optional callbacks (not required).
    // CN: 设置可选回调（非必须）。
    HOOK.set_before(|| log::info!("before"));
    HOOK.set_after(|| log::info!("after"));

    unsafe {
        HOOK.install(
            common::target_add as fn(i32) -> i32,
            detour_add as fn(i32) -> i32,
        )?;
    }

    let v = common::target_add(1);
    println!("target_add(1) = {v}");

    unsafe {
        HOOK.uninstall()?;
    }
    Ok(())
}

pub fn call_before(&self)

Examples found in repository

examples/static_hook_basic.rs (line 16)

fn detour_add(x: i32) -> i32 {
    // EN: Optional: run user callbacks.
    // CN: 可选：执行用户的 before/after 回调。
    HOOK.call_before();

    // EN: Call the original implementation with modified arguments.
    // CN: 修改参数后调用原函数。
    let out = (HOOK.original())(x + 100);

    HOOK.call_after();

    // EN: Post-process return value.
    // CN: 对返回值做二次处理。
    out + 10
}

pub fn call_after(&self)

Examples found in repository

examples/static_hook_basic.rs (line 22)

fn detour_add(x: i32) -> i32 {
    // EN: Optional: run user callbacks.
    // CN: 可选：执行用户的 before/after 回调。
    HOOK.call_before();

    // EN: Call the original implementation with modified arguments.
    // CN: 修改参数后调用原函数。
    let out = (HOOK.original())(x + 100);

    HOOK.call_after();

    // EN: Post-process return value.
    // CN: 对返回值做二次处理。
    out + 10
}

pub unsafe fn install(&self, target: F, detour: F) -> Result<()>

Examples found in repository

examples/static_hook_basic.rs (lines 38-41)

fn main() -> dobby_rs_framework::Result<()> {
    common::init_example_logging();

    // EN: Set optional callbacks (not required).
    // CN: 设置可选回调（非必须）。
    HOOK.set_before(|| log::info!("before"));
    HOOK.set_after(|| log::info!("after"));

    unsafe {
        HOOK.install(
            common::target_add as fn(i32) -> i32,
            detour_add as fn(i32) -> i32,
        )?;
    }

    let v = common::target_add(1);
    println!("target_add(1) = {v}");

    unsafe {
        HOOK.uninstall()?;
    }
    Ok(())
}

pub unsafe fn uninstall(&self) -> Result<()>

Examples found in repository

examples/static_hook_basic.rs (line 48)

fn main() -> dobby_rs_framework::Result<()> {
    common::init_example_logging();

    // EN: Set optional callbacks (not required).
    // CN: 设置可选回调（非必须）。
    HOOK.set_before(|| log::info!("before"));
    HOOK.set_after(|| log::info!("after"));

    unsafe {
        HOOK.install(
            common::target_add as fn(i32) -> i32,
            detour_add as fn(i32) -> i32,
        )?;
    }

    let v = common::target_add(1);
    println!("target_add(1) = {v}");

    unsafe {
        HOOK.uninstall()?;
    }
    Ok(())
}

pub fn original(&self) -> F

Examples found in repository

examples/static_hook_basic.rs (line 20)

fn detour_add(x: i32) -> i32 {
    // EN: Optional: run user callbacks.
    // CN: 可选：执行用户的 before/after 回调。
    HOOK.call_before();

    // EN: Call the original implementation with modified arguments.
    // CN: 修改参数后调用原函数。
    let out = (HOOK.original())(x + 100);

    HOOK.call_after();

    // EN: Post-process return value.
    // CN: 对返回值做二次处理。
    out + 10
}

Trait Implementations

impl<F: Copy> Default for StaticHook<F>

fn default() -> Self

Returns the “default value” for a type.