chore: 让窗口化不依赖 d3d9

Author: clansty

packages/applechu/src/d3d9/mod.rs

@@ -9,6 +9,32 @@ use crate::util::api::Api;
 
 static FPS_ENABLED: AtomicBool = AtomicBool::new(false);
 
+#[repr(C)]
+#[derive(Clone, Copy, Default)]
+pub(crate) struct D3dPresentParameters {
+    back_buffer_width: u32,
+    back_buffer_height: u32,
+    back_buffer_format: u32,
+    back_buffer_count: u32,
+    multi_sample_type: u32,
+    multi_sample_quality: u32,
+    swap_effect: u32,
+    device_window: usize,
+    pub(crate) windowed: i32,
+    enable_auto_depth_stencil: i32,
+    auto_depth_stencil_format: u32,
+    flags: u32,
+    pub(crate) full_screen_refresh_rate_in_hz: u32,
+    presentation_interval: u32,
+}
+
+impl D3dPresentParameters {
+    pub(crate) fn force_windowed(&mut self) {
+        self.windowed = 1;
+        self.full_screen_refresh_rate_in_hz = 0;
+    }
+}
+
 crate::config_section! {
     pub(crate) struct FpsDisplayConfig => FPS_DISPLAY_CONFIG_SECTION {
         section: "FpsDisplay",
@@ -72,3 +98,25 @@ unsafe extern "C" fn on_present(device: *mut c_void) {
     }
     osd::render(device);
 }
+
+#[cfg(test)]
+mod tests {
+    use super::D3dPresentParameters;
+
+    #[test]
+    fn force_windowed_sets_required_d3d_fields() {
+        // Given: 全屏展示参数带有非零刷新率。
+        let mut parameters = D3dPresentParameters {
+            windowed: 0,
+            full_screen_refresh_rate_in_hz: 60,
+            ..Default::default()
+        };
+
+        // When: 窗口模式在进入 D3D9 前被强制应用。
+        parameters.force_windowed();
+
+        // Then: D3D9 同时收到窗口标志与窗口模式要求的刷新率。
+        assert_eq!(parameters.windowed, 1);
+        assert_eq!(parameters.full_screen_refresh_rate_in_hz, 0);
+    }
+}

packages/applechu/src/gfx/d3d9.rs

@@ -5,6 +5,7 @@ use std::sync::atomic::{AtomicBool, AtomicU32, AtomicUsize, Ordering};
 use once_cell::sync::OnceCell;
 
 use crate::config::Config;
+use crate::d3d9::D3dPresentParameters;
 use crate::gfx::WindowConfig;
 use crate::util::api::Api;
 use crate::util::iat_hook::hook_iat;
@@ -55,25 +56,6 @@ static DEVICE_LOST_RECOVER: AtomicBool = AtomicBool::new(true);
 static D3D9_VTABLE: OnceCell<Box<[usize; 17]>> = OnceCell::new();
 static DEVICE_VTABLE: OnceCell<Box<[usize; 119]>> = OnceCell::new();
 
-#[repr(C)]
-#[derive(Clone, Copy)]
-struct D3dPresentParameters {
-    back_buffer_width: u32,
-    back_buffer_height: u32,
-    back_buffer_format: u32,
-    back_buffer_count: u32,
-    multi_sample_type: u32,
-    multi_sample_quality: u32,
-    swap_effect: u32,
-    device_window: usize,
-    windowed: i32,
-    enable_auto_depth_stencil: i32,
-    auto_depth_stencil_format: u32,
-    flags: u32,
-    full_screen_refresh_rate_in_hz: u32,
-    presentation_interval: u32,
-}
-
 #[repr(C)]
 struct D3d9ExProxy {
     vtable: *const usize,
@@ -510,8 +492,7 @@ unsafe extern "system" fn d3d9_create_device(
 
     let selected_adapter = MONITOR_INDEX.load(Ordering::SeqCst);
     if WINDOWED.load(Ordering::SeqCst) && !presentation_parameters.is_null() {
-        (*presentation_parameters).windowed = 1;
-        (*presentation_parameters).full_screen_refresh_rate_in_hz = 0;
+        (*presentation_parameters).force_windowed();
     }
 
     let real = (*this).real;

packages/applechu/src/gfx/windowed.rs

@@ -2,6 +2,7 @@ use std::ffi::c_void;
 use std::sync::atomic::{AtomicBool, AtomicUsize, Ordering};
 
 use crate::gfx::WindowConfig;
+use crate::proxy::set_windowed_mode;
 use crate::util::api::Api;
 use crate::util::iat_hook::hook_iat_all_modules;
 
@@ -50,6 +51,7 @@ extern "system" {
 
 #[applechu_macros::config_section(stage = Graphics, order = 10)]
 pub fn init(api: &Api, config: &WindowConfig) {
+    set_windowed_mode(config.windowed);
     if !config.windowed {
         return;
     }

packages/applechu/src/proxy/d3d9/hooks.rs

@@ -66,13 +66,19 @@ unsafe extern "system" fn hooked_create_device(
     device_type: u32,
     focus_window: usize,
     behavior_flags: u32,
-    presentation_parameters: *mut c_void,
+    presentation_parameters: *mut D3dPresentParameters,
     returned_device_interface: *mut *mut c_void,
 ) -> i32 {
     let addr = ORIGINAL_CREATE_DEVICE.load(Ordering::SeqCst);
     if addr == 0 {
         return -1;
     }
+    if WINDOWED_MODE.load(Ordering::SeqCst) {
+        // SAFETY: [类别 8：FFI 边界] Direct3D 保证非空参数在调用期间指向可写且正确对齐的展示参数。
+        if let Some(parameters) = unsafe { presentation_parameters.as_mut() } {
+            parameters.force_windowed();
+        }
+    }
     let original: CreateDeviceFn = std::mem::transmute(addr);
     let result = original(
         this,
@@ -94,7 +100,7 @@ unsafe extern "system" fn hooked_create_device(
     result
 }
 
-unsafe fn hook_device(device: *mut c_void, presentation_parameters: *mut c_void) {
+unsafe fn hook_device(device: *mut c_void, presentation_parameters: *mut D3dPresentParameters) {
     if DEVICE_HOOKED.swap(true, Ordering::SeqCst) {
         return;
     }
@@ -164,3 +170,52 @@ unsafe fn hook_slot(
         log_warn(&format!("d3d9: {name} vtable write failed"));
     }
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    unsafe extern "system" fn fake_create_device(
+        _this: *mut c_void,
+        _adapter: u32,
+        _device_type: u32,
+        _focus_window: usize,
+        _behavior_flags: u32,
+        _presentation_parameters: *mut D3dPresentParameters,
+        _returned_device_interface: *mut *mut c_void,
+    ) -> i32 {
+        0
+    }
+
+    #[test]
+    #[cfg_attr(miri, ignore = "Win32 vtable 函数地址通过 usize 保存")]
+    fn create_device_forces_windowed_without_d3d9ex() {
+        // Given: loader 直接代理普通 D3D9，游戏仍传入全屏参数。
+        let previous_create_device =
+            ORIGINAL_CREATE_DEVICE.swap(fake_create_device as *const () as usize, Ordering::SeqCst);
+        let previous_windowed = WINDOWED_MODE.swap(true, Ordering::SeqCst);
+        let mut parameters = D3dPresentParameters::default();
+        parameters.full_screen_refresh_rate_in_hz = 60;
+
+        // When: 参数经过 loader 的通用 CreateDevice hook。
+        // SAFETY: [类别 8：FFI 边界] 假函数签名与 CreateDeviceFn 完全一致，参数在本次调用期间有效。
+        let result = unsafe {
+            hooked_create_device(
+                std::ptr::null_mut(),
+                0,
+                0,
+                0,
+                0,
+                &mut parameters,
+                std::ptr::null_mut(),
+            )
+        };
+        ORIGINAL_CREATE_DEVICE.store(previous_create_device, Ordering::SeqCst);
+        WINDOWED_MODE.store(previous_windowed, Ordering::SeqCst);
+
+        // Then: 普通 D3D9 后端也收到窗口展示参数。
+        assert_eq!(result, 0);
+        assert_eq!(parameters.windowed, 1);
+        assert_eq!(parameters.full_screen_refresh_rate_in_hz, 0);
+    }
+}

packages/applechu/src/proxy/d3d9/mod.rs

@@ -13,6 +13,7 @@ use std::sync::atomic::{AtomicBool, AtomicU32, AtomicUsize, Ordering};
 
 use chu_abi::{ChuModPresentCallback, ChuModResetCallback};
 
+use crate::d3d9::D3dPresentParameters;
 use crate::proxy::loader::log::{log_info, log_warn};
 
 use self::iat_hook::{hook_iat, patch_slot, vtable_slot};
@@ -42,7 +43,7 @@ type CreateDeviceFn = unsafe extern "system" fn(
     u32,
     usize,
     u32,
-    *mut c_void,
+    *mut D3dPresentParameters,
     *mut *mut c_void,
 ) -> i32;
 type PresentFn = unsafe extern "system" fn(
@@ -60,6 +61,7 @@ static HOOK_INSTALLED: AtomicBool = AtomicBool::new(false);
 static ORIGINAL_DIRECT3D_CREATE9: AtomicUsize = AtomicUsize::new(0);
 static ORIGINAL_CREATE_DEVICE: AtomicUsize = AtomicUsize::new(0);
 static DEVICE_HOOKED: AtomicBool = AtomicBool::new(false);
+static WINDOWED_MODE: AtomicBool = AtomicBool::new(false);
 
 static ORIGINAL_PRESENT: AtomicUsize = AtomicUsize::new(0);
 static ORIGINAL_RESET: AtomicUsize = AtomicUsize::new(0);
@@ -96,6 +98,10 @@ static RESET_CALLBACKS: [AtomicUsize; MAX_RESET_CALLBACKS] = [
     AtomicUsize::new(0),
 ];
 
+pub(crate) fn set_windowed_mode(enabled: bool) {
+    WINDOWED_MODE.store(enabled, Ordering::SeqCst);
+}
+
 #[link(name = "kernel32")]
 extern "system" {
     fn QueryPerformanceCounter(count: *mut i64) -> i32;

packages/applechu/src/proxy/mod.rs

@@ -15,14 +15,14 @@ use std::ptr;
 
 use windows_sys::Win32::Foundation::{BOOL, HMODULE, TRUE};
 use windows_sys::Win32::System::Diagnostics::Debug::FlushInstructionCache;
-use windows_sys::Win32::System::LibraryLoader::{
-    DisableThreadLibraryCalls, GetModuleHandleA,
-};
+use windows_sys::Win32::System::LibraryLoader::{DisableThreadLibraryCalls, GetModuleHandleA};
 use windows_sys::Win32::System::Memory::{
     VirtualAlloc, VirtualProtect, MEM_COMMIT, MEM_RESERVE, PAGE_EXECUTE_READWRITE,
 };
 use windows_sys::Win32::System::Threading::GetCurrentProcess;
 
+pub(crate) use d3d9::set_windowed_mode;
+
 const DLL_PROCESS_ATTACH: u32 = 1;
 const DLL_PROCESS_DETACH: u32 = 0;
 const JMP_REL32_LEN: usize = 5;