如何通过Rust FFI正确链接Direct2D接口方法？

简单解决步骤 #

出现LNK2019错误的核心原因是：Direct2D属于COM接口，自定义绑定时你只声明了方法签名，但未正确链接到Direct2D的实现库，也没处理COM接口特有的vtable调用逻辑。解决方法分两步：

1. 链接Direct2D的导入库 #

在你的Rust代码中添加链接属性，告诉编译器链接d2d1.lib（Direct2D的导入库）：

#[link(name = "d2d1")]
extern "system" {
    // 声明D2D1CreateFactory等全局函数
    fn D2D1CreateFactory(
        factory_type: D2D1_FACTORY_TYPE,
        riid: *const GUID,
        factory: *mut *mut ID2D1Factory,
    ) -> HRESULT;
}

或者在Cargo.toml的[package]下添加全局链接参数：

rustflags = ["-C", "link-args=/DEFAULTLIB:d2d1.lib"]

2. 正确实现COM接口的vtable调用 #

COM接口的方法不是直接调用的，需要通过对象的vtable指针间接调用。你必须严格按照COM接口的vtable结构定义类型，比如ID2D1Factory的vtable前三个方法是IUnknown的标准方法（QueryInterface、AddRef、Release），之后才是Direct2D的专属方法：

#[repr(C)]
struct IUnknownVTable {
    QueryInterface: unsafe extern "system" fn(*mut IUnknown, *const GUID, *mut *mut c_void) -> HRESULT,
    AddRef: unsafe extern "system" fn(*mut IUnknown) -> u32,
    Release: unsafe extern "system" fn(*mut IUnknown) -> u32,
}

#[repr(C)]
struct IUnknown {
    lpVtbl: *const IUnknownVTable,
}

#[repr(C)]
struct ID2D1FactoryVTable {
    base: IUnknownVTable,
    CreateHwndRenderTarget: unsafe extern "system" fn(
        *mut ID2D1Factory,
        *const D2D1_HWND_RENDER_TARGET_PROPERTIES,
        *mut *mut ID2D1HwndRenderTarget
    ) -> HRESULT,
    // 按需添加其他Direct2D方法
}

#[repr(C)]
struct ID2D1Factory {
    base: IUnknown,
}

impl ID2D1Factory {
    unsafe fn create_hwnd_render_target(
        &self,
        props: *const D2D1_HWND_RENDER_TARGET_PROPERTIES,
        render_target: *mut *mut ID2D1HwndRenderTarget
    ) -> HRESULT {
        ((*self.base.lpVtbl as *const ID2D1FactoryVTable).CreateHwndRenderTarget)(
            self as *mut _,
            props,
            render_target
        )
    }
}

注意必须保证vtable中方法的顺序和官方定义完全一致，否则会出现调用错误或程序崩溃。

与windows-rs、winapi-rs的差异 #

winapi-rs #

• 本质是手动维护的C风格绑定集合，将Win32/COM的类型、函数、常量逐一映射为Rust类型。
• 自动处理库链接（比如引入winapi-d2d1 crate后，会自动链接d2d1.lib）。
• 仅提供基础绑定，需要你手动处理COM接口的生命周期（比如手动调用AddRef/Release）和vtable调用逻辑。
• 优势是轻量，可按需引入模块，编译速度快。

windows-rs #

• 微软官方维护的库，基于Windows元数据（.winmd）自动生成绑定，能同步支持最新Windows API。
• 封装了COM接口的生命周期管理，提供ComPtr智能指针自动处理AddRef/Release。
• 将HRESULT转换为Rust的Result类型，提供更符合Rust习惯的API设计。
• 优势是自动化程度高，减少手动绑定的错误，但体积较大，依赖代码生成工具。

你的自定义绑定做法 #

• 完全手动编写类型和函数签名，需要自己处理所有细节：库链接、vtable布局、COM生命周期、参数传递等，出错概率高。
• 灵活性最高，但维护成本极大，不适合复杂的Windows API场景。

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