windows-drivers-rs 开源项目教程

1. 目录结构及介绍

该项目主要由多个Rust crate组成，以下是一些关键的目录和其作用：

• wdk-build: 用于配置Cargo构建脚本以支持绑定生成和Windows驱动工具包（WDK）的下游链接。
• wdk-sys: 提供对WDK中API的直接FFI绑定，包括自动生成的bindgen绑定和手动重实现的宏。

通常，项目的目录结构会是这样的：

windows-drivers-rs/
├── Cargo.toml
├── README.md
└── src/
    ├── lib.rs
    └── ...

其中，Cargo.toml 是项目的主配置文件，src 目录包含了项目的主要源代码。

2. 启动文件介绍

在 windows-drivers-rs 中，每个驱动都有自己的入口点，通常是通过DriverEntry函数来实现的。例如，在你的lib.rs 文件中，你会看到类似下面的定义：

use wdk_sys::{DRIVER_OBJECT, NTSTATUS, PCUNICODE_STRING};

#[export_name = "DriverEntry"]
// WDF期望一个名为DriverEntry的符号
pub unsafe extern "system" fn driver_entry(driver: &mut DRIVER_OBJECT, registry_path: PCUNICODE_STRING) -> NTSTATUS {
    // ... 实现你的驱动逻辑
    unimplemented!("Provide actual driver entry logic here");
}

这个driver_entry 函数就是驱动程序的核心，它会在系统加载驱动时被调用。

3. 配置文件介绍

Cargo.toml

Cargo.toml 是Rust项目的构建和依赖管理配置文件。对于 windows-drivers-rs，你可能会在这里声明项目名称、版本以及所依赖的库，如wdk-build 和 wdk-sys:

[package]
name = "your_driver_name"
version = "0.1.0"
authors = ["Your Name <[e-mail]>"]
edition = "2018"

[dependencies]
wdk-build = "x.x.x"  # 更新为实际版本号
wdk-sys = "x.x.x"    # 更新为实际版本号

[profile.release]
lto = true
opt-level = 3

额外配置

除了Cargo.toml，可能还需要配置特定于Windows驱动的属性，例如将项目标记为no_std并在lib.rs中设置全局恐慌处理程序和分配器。这可以在lib.rs中找到：

#![no_std]

extern crate wdk_panic;  // 引入恐慌处理库

#[cfg(not(test))]
use wdk_alloc::WDKAllocator;
#[cfg(not(test))]
#[global_allocator]
static GLOBAL_ALLOCATOR: WDKAllocator = WDKAllocator;

// 其他代码...

这些配置确保了驱动程序遵循Windows驱动的标准要求并适当地处理错误情况。

请注意，具体配置可能会因驱动类型和需求而异，以上示例只是一个基础模板。在实际开发中，根据项目和WDK的最新文档进行适当的调整是至关重要的。