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
111
112
113
114
115
116
117
118
119
120
121
122
123

//! Generated by `cargo xtask gen` from the `windows` crate's `ID3D12Tools_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 `ID3D12Tools` in vtable order. The defaults forward to the wrapped object [`Tools12Methods::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 `ID3D12Tools`.
pub unsafe trait Tools12Methods: Sized {
    /// The wrapped object, an `ID3D12Tools`.
    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 EnableShaderInstrumentation(&self, a0: windows::core::BOOL) {
        unsafe { real::EnableShaderInstrumentation(self.inner(), a0) }
    }
    unsafe fn ShaderInstrumentationEnabled(&self) -> windows::core::BOOL {
        unsafe { real::ShaderInstrumentationEnabled(self.inner()) }
    }
}

/// 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;

    /// `EnableShaderInstrumentation` on the real object.
    pub unsafe fn EnableShaderInstrumentation(inner: *mut c_void, a0: windows::core::BOOL) {
        unsafe {
            ((*(*(inner as *const *const windows::Win32::Graphics::Direct3D12::ID3D12Tools_Vtbl)))
                .EnableShaderInstrumentation)(inner, a0)
        }
    }
    /// `ShaderInstrumentationEnabled` on the real object.
    pub unsafe fn ShaderInstrumentationEnabled(inner: *mut c_void) -> windows::core::BOOL {
        unsafe {
            ((*(*(inner as *const *const windows::Win32::Graphics::Direct3D12::ID3D12Tools_Vtbl)))
                .ShaderInstrumentationEnabled)(inner)
        }
    }
}

unsafe extern "system" fn QueryInterface<T: Tools12Methods>(
    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: Tools12Methods>(this: *mut c_void) -> u32 {
    unsafe { (*(this as *const T)).AddRef() }
}
unsafe extern "system" fn Release<T: Tools12Methods>(this: *mut c_void) -> u32 {
    unsafe { (*(this as *const T)).Release() }
}
unsafe extern "system" fn EnableShaderInstrumentation<T: Tools12Methods>(
    this: *mut c_void,
    a0: windows::core::BOOL,
) {
    unsafe { (*(this as *const T)).EnableShaderInstrumentation(a0) }
}
unsafe extern "system" fn ShaderInstrumentationEnabled<T: Tools12Methods>(
    this: *mut c_void,
) -> windows::core::BOOL {
    unsafe { (*(this as *const T)).ShaderInstrumentationEnabled() }
}

#[allow(clippy::let_and_return)] // Uniform post-call interception in generated methods.
unsafe impl Tools12Methods 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 EnableShaderInstrumentation(&self, a0: windows::core::BOOL) {
        unsafe {
            real::EnableShaderInstrumentation(self.real(), a0);
        }
    }
    unsafe fn ShaderInstrumentationEnabled(&self) -> windows::core::BOOL {
        unsafe {
            let result = real::ShaderInstrumentationEnabled(self.real());
            result
        }
    }
}

/// The `ID3D12Tools` vtable whose entries call `T`'s methods.
pub const fn vtable<T: Tools12Methods>() -> windows::Win32::Graphics::Direct3D12::ID3D12Tools_Vtbl {
    windows::Win32::Graphics::Direct3D12::ID3D12Tools_Vtbl {
        base__: windows::core::IUnknown_Vtbl {
            QueryInterface: QueryInterface::<T>,
            AddRef: AddRef::<T>,
            Release: Release::<T>,
        },
        EnableShaderInstrumentation: EnableShaderInstrumentation::<T>,
        ShaderInstrumentationEnabled: ShaderInstrumentationEnabled::<T>,
    }
}