Struct ReplaceHandle 

pub struct ReplaceHandle<F: Copy> { /* private fields */ }

Implementations

impl<F: Copy> ReplaceHandle<F>

pub fn original(&self) -> F

Examples found in repository

examples/install_replace.rs (line 86)

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

    // EN: 1) `install` -> typed handle.
    // CN: 1) `install` -> 返回带类型的句柄。
    let h1 = unsafe {
        install(
            common::target_mul as fn(i32) -> i32,
            detour_mul as fn(i32) -> i32,
        )?
    };
    println!("target_mul(3) after install = {}", common::target_mul(3));
    unsafe { h1.unhook()? };

    // EN: 2) `install_addr` -> raw pointer variant.
    // CN: 2) `install_addr` -> 按地址安装（裸指针版本）。
    let h1_addr = unsafe {
        install_addr(
            common::target_mul as *const () as *mut c_void,
            detour_mul as *const () as *mut c_void,
        )?
    };
    println!(
        "target_mul(3) after install_addr = {}",
        common::target_mul(3)
    );
    unsafe { h1_addr.unhook()? };

    // EN: 3) `replace` -> temporary swap, with easy access to original.
    // CN: 3) `replace` -> 临时替换，并且可以拿到 original。
    let r = unsafe {
        replace(
            common::target_sub as fn(i32) -> i32,
            replacement_sub as fn(i32) -> i32,
        )?
    };
    println!("target_sub(10) after replace = {}", common::target_sub(10));
    println!("original target_sub(10) = {}", (r.original())(10));
    unsafe { r.unreplace()? };

    // EN: 4) `install_with` -> before/after callbacks (invoked by detour).
    // CN: 4) `install_with` -> before/after 回调（由 detour 调用）。
    let h2 = unsafe {
        install_with(
            target_with_callbacks as fn(i32) -> i32,
            detour_with_callbacks as fn(i32) -> i32,
            Some(|| log::info!("before (install_with)")),
            Some(|| log::info!("after (install_with)")),
        )?
    };
    println!(
        "target_with_callbacks(1) after install_with = {}",
        target_with_callbacks(1)
    );
    unsafe { h2.unhook()? };

    Ok(())
}

pub unsafe fn unreplace(self) -> Result<()>

Examples found in repository

examples/install_replace.rs (line 87)

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

    // EN: 1) `install` -> typed handle.
    // CN: 1) `install` -> 返回带类型的句柄。
    let h1 = unsafe {
        install(
            common::target_mul as fn(i32) -> i32,
            detour_mul as fn(i32) -> i32,
        )?
    };
    println!("target_mul(3) after install = {}", common::target_mul(3));
    unsafe { h1.unhook()? };

    // EN: 2) `install_addr` -> raw pointer variant.
    // CN: 2) `install_addr` -> 按地址安装（裸指针版本）。
    let h1_addr = unsafe {
        install_addr(
            common::target_mul as *const () as *mut c_void,
            detour_mul as *const () as *mut c_void,
        )?
    };
    println!(
        "target_mul(3) after install_addr = {}",
        common::target_mul(3)
    );
    unsafe { h1_addr.unhook()? };

    // EN: 3) `replace` -> temporary swap, with easy access to original.
    // CN: 3) `replace` -> 临时替换，并且可以拿到 original。
    let r = unsafe {
        replace(
            common::target_sub as fn(i32) -> i32,
            replacement_sub as fn(i32) -> i32,
        )?
    };
    println!("target_sub(10) after replace = {}", common::target_sub(10));
    println!("original target_sub(10) = {}", (r.original())(10));
    unsafe { r.unreplace()? };

    // EN: 4) `install_with` -> before/after callbacks (invoked by detour).
    // CN: 4) `install_with` -> before/after 回调（由 detour 调用）。
    let h2 = unsafe {
        install_with(
            target_with_callbacks as fn(i32) -> i32,
            detour_with_callbacks as fn(i32) -> i32,
            Some(|| log::info!("before (install_with)")),
            Some(|| log::info!("after (install_with)")),
        )?
    };
    println!(
        "target_with_callbacks(1) after install_with = {}",
        target_with_callbacks(1)
    );
    unsafe { h2.unhook()? };

    Ok(())
}