使用Rust的windows-rs调用D3D12GetDebugInterface报接口不支持错误

错误信息：

failed to get d3d12 debug interface: No such interface supported (0x80004002)

我的代码实现：

#[derive(Default)]
struct DebugLayer {
    d3d12_debug: Option<ID3D12Debug6>,
    dxgi_debug: Option<IDXGIDebug1>,
}

impl DebugLayer {
    fn init() -> Self {
        unsafe {
            let mut debug_layer = Self::default();

            match D3D12GetDebugInterface(&mut debug_layer.d3d12_debug) {
                Ok(()) => {
                    if let Some(ref d3d12_debug) = debug_layer.d3d12_debug {
                        d3d12_debug.EnableDebugLayer();
                        println!("d3d12: debug layer enabled");

                        match DXGIGetDebugInterface1::<IDXGIDebug1>(0) {
                            Ok(dxgi_debug) => {
                                dxgi_debug.EnableLeakTrackingForThread();
                                println!("d3d12: leak tracking enabled");

                                debug_layer.dxgi_debug = Some(dxgi_debug);
                            }

                            Err(err) => println!("failed to get dxgi debug interface: {}", err),
                        }
                    }
                }

                Err(err) => println!("failed to get d3d12 debug interface: {}", err),
            }

            debug_layer
        }
    }
}

Cargo.toml配置：

[target.'cfg(target_os = "windows")'.dependencies.windows]
version = "0.52.0"
features = [
    "Win32_Foundation",
    "Win32_Graphics_Gdi",
    "Win32_Graphics_Direct3D_Fxc",
    "Win32_Graphics_Direct3D12",
    "Win32_Graphics_Dxgi_Common",
    "Win32_Security",
    "Win32_System_LibraryLoader",
    "Win32_System_Threading",
    "Win32_System_WindowsProgramming",
    "Win32_UI_Input_KeyboardAndMouse",
    "Win32_UI_WindowsAndMessaging",
]

环境说明：Windows 10系统，已安装Graphics Tools。请问遗漏了什么或操作有误？

1. 接口版本兼容性问题 #

ID3D12Debug6是较新的接口版本，仅支持Windows 10 20H1（版本2004）及以上。如果你的系统版本低于这个阈值，就会出现找不到接口的错误。

解决办法：降级使用更低版本的Debug接口，比如ID3D12Debug3或基础的ID3D12Debug，这些接口在Windows 10早期版本中也能正常工作。修改代码中的类型定义：

d3d12_debug: Option<ID3D12Debug3>, // 或直接使用ID3D12Debug

2. 运行权限与组件加载问题 #

• 尝试以管理员权限运行程序，部分D3D12 Debug组件需要高权限才能完成初始化。
• 确认系统已安装最新的DirectX Runtime，确保Debug库文件是完整且最新的。

3. 初始化时机问题 #

必须在创建任何D3D12设备之前调用D3D12GetDebugInterface。如果已经创建了设备再初始化Debug层，也会导致接口获取失败。

4. 兼容式接口获取方案 #

如果不确定系统支持的最高Debug接口版本，可以先获取基础接口，再尝试向上转换：

let mut base_debug: Option<ID3D12Debug> = None;
if D3D12GetDebugInterface(&mut base_debug).is_ok() {
    // 尝试转换到更高版本的接口
    match base_debug.as_ref().unwrap().cast::<ID3D12Debug3>() {
        Ok(debug3) => {
            debug3.EnableDebugLayer();
            // 后续操作
        }
        Err(_) => {
            // 降级使用基础接口
            base_debug.unwrap().EnableDebugLayer();
        }
    }
}

内容的提问来源于stack exchange，提问作者junglie85