locum 0.1.4

Captures everything a Direct3D 11 game draws in a frame, to look at, query, change and replay: d3d11.dll and dxgi.dll beside the game that watch every call on its way to the real runtime.
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

//! Generated by `cargo xtask gen` from the `windows` crate's `ID3D12Debug2_Vtbl`; do not edit.

#![allow(
    non_snake_case,
    clippy::too_many_arguments,
    clippy::missing_safety_doc,
    dead_code
)]

use core::ffi::c_void;

/// Every method of `ID3D12Debug2` in vtable order. The defaults forward to the wrapped object [`Debug2_12Methods::inner`].
///
/// # Safety
/// The implementing type must be `#[repr(C)]` with a pointer to [`vtable`]'s table as its first field,
/// and `inner` must return a live `ID3D12Debug2`.
pub unsafe trait Debug2_12Methods: Sized {
    /// The wrapped object, an `ID3D12Debug2`.
    fn inner(&self) -> *mut c_void;
    unsafe fn QueryInterface(
        &self,
        iid: *const windows::core::GUID,
        out: *mut *mut c_void,
    ) -> windows::core::HRESULT;
    unsafe fn AddRef(&self) -> u32;
    unsafe fn Release(&self) -> u32;
    unsafe fn SetGPUBasedValidationFlags(
        &self,
        a0: windows::Win32::Graphics::Direct3D12::D3D12_GPU_BASED_VALIDATION_FLAGS,
    ) {
        unsafe { real::SetGPUBasedValidationFlags(self.inner(), a0) }
    }
}

/// Each method called on the real (wrapped) object: the trait's defaults, and overrides that still want the
/// real behaviour.
pub mod real {
    use core::ffi::c_void;

    /// `SetGPUBasedValidationFlags` on the real object.
    pub unsafe fn SetGPUBasedValidationFlags(
        inner: *mut c_void,
        a0: windows::Win32::Graphics::Direct3D12::D3D12_GPU_BASED_VALIDATION_FLAGS,
    ) {
        unsafe {
            ((*(*(inner as *const *const windows::Win32::Graphics::Direct3D12::ID3D12Debug2_Vtbl)))
                .SetGPUBasedValidationFlags)(inner, a0)
        }
    }
}

unsafe extern "system" fn QueryInterface<T: Debug2_12Methods>(
    this: *mut c_void,
    iid: *const windows::core::GUID,
    out: *mut *mut c_void,
) -> windows::core::HRESULT {
    unsafe { (*(this as *const T)).QueryInterface(iid, out) }
}
unsafe extern "system" fn AddRef<T: Debug2_12Methods>(this: *mut c_void) -> u32 {
    unsafe { (*(this as *const T)).AddRef() }
}
unsafe extern "system" fn Release<T: Debug2_12Methods>(this: *mut c_void) -> u32 {
    unsafe { (*(this as *const T)).Release() }
}
unsafe extern "system" fn SetGPUBasedValidationFlags<T: Debug2_12Methods>(
    this: *mut c_void,
    a0: windows::Win32::Graphics::Direct3D12::D3D12_GPU_BASED_VALIDATION_FLAGS,
) {
    unsafe { (*(this as *const T)).SetGPUBasedValidationFlags(a0) }
}

#[allow(clippy::let_and_return)] // Uniform post-call interception in generated methods.
unsafe impl Debug2_12Methods for crate::d3d12::Object {
    fn inner(&self) -> *mut c_void {
        self.real()
    }
    unsafe fn QueryInterface(
        &self,
        iid: *const windows::core::GUID,
        out: *mut *mut c_void,
    ) -> windows::core::HRESULT {
        unsafe { self.query(iid, out) }
    }
    unsafe fn AddRef(&self) -> u32 {
        self.add_ref()
    }
    unsafe fn Release(&self) -> u32 {
        unsafe { self.release() }
    }
    unsafe fn SetGPUBasedValidationFlags(
        &self,
        a0: windows::Win32::Graphics::Direct3D12::D3D12_GPU_BASED_VALIDATION_FLAGS,
    ) {
        unsafe {
            real::SetGPUBasedValidationFlags(self.real(), a0);
        }
    }
}

/// The `ID3D12Debug2` vtable whose entries call `T`'s methods.
pub const fn vtable<T: Debug2_12Methods>() -> windows::Win32::Graphics::Direct3D12::ID3D12Debug2_Vtbl {
    windows::Win32::Graphics::Direct3D12::ID3D12Debug2_Vtbl {
        base__: windows::core::IUnknown_Vtbl {
            QueryInterface: QueryInterface::<T>,
            AddRef: AddRef::<T>,
            Release: Release::<T>,
        },
        SetGPUBasedValidationFlags: SetGPUBasedValidationFlags::<T>,
    }
}