Struct ShadowVmt 

pub struct ShadowVmt<T: ?Sized = ()> { /* private fields */ }

shadow VMT for instance-specific hooking

creates a copy of the original vtable and replaces the object’s vptr to point to the shadow copy. this allows hooking specific instances without affecting other objects of the same class.

Implementations

impl<T: ?Sized> ShadowVmt<T>

pub unsafe fn new(object: *mut (), vtable_size: usize) -> Result<Self>

create a shadow VMT for an object

Arguments

• object - pointer to the C++ object
• vtable_size - number of entries in the vtable

Safety

The object must be a valid C++ object with a vtable. vtable_size must be accurate (too small = missing functions, too large = garbage).

Example

// create shadow for an object with 10 virtual functions
let mut shadow = unsafe { ShadowVmt::new(object_ptr, 10)? };

// hook the 3rd virtual function
shadow.hook(2, my_detour as usize)?;

// get original to call
let original: fn() = unsafe { std::mem::transmute(shadow.original(2)) };

pub fn hook(&mut self, index: usize, detour: usize) -> Result<()>

hook a virtual function by index

Arguments

• index - vtable index to hook
• detour - address of the detour function

pub fn unhook(&mut self, index: usize) -> Result<()>

unhook a specific index

pub fn unhook_all(&mut self)

unhook all

pub fn original(&self, index: usize) -> Option<usize>

get the original function at an index

pub fn original_vtable(&self) -> usize

get the original vtable address

pub fn shadow_vtable(&self) -> usize

get the shadow vtable address

pub fn vtable_size(&self) -> usize

get the vtable size

pub fn is_hooked(&self, index: usize) -> bool

check if an index is hooked

pub fn hook_count(&self) -> usize

get number of active hooks

pub fn set_auto_restore(&mut self, restore: bool)

set whether to auto-restore on drop

pub fn restore(self) -> Result<()>

restore and consume

Trait Implementations

impl<T: ?Sized> Drop for ShadowVmt<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: ?Sized> Send for ShadowVmt<T>

impl<T: ?Sized> Sync for ShadowVmt<T>