Windows Rust 驱动程序示例项目安装和配置指南

Windows Rust 驱动程序示例项目安装和配置指南

Windows-rust-driver-samples Rust port of the official Windows Driver Samples on Github. Leverages windows-drivers-rs 项目地址: https://gitcode.com/gh_mirrors/wi/Windows-rust-driver-samples

1. 项目基础介绍和主要编程语言

项目基础介绍

Windows Rust 驱动程序示例项目是由微软开发的一个开源项目，旨在为开发者提供使用 Rust 语言编写 Windows 驱动程序的示例和最佳实践。该项目是官方 Windows 驱动程序示例的 Rust 移植版本，利用了 windows-drivers-rs 库。

主要编程语言

该项目主要使用 Rust 编程语言。Rust 是一种系统编程语言，以其内存安全性和并发性著称，非常适合用于编写底层驱动程序。

2. 项目使用的关键技术和框架

关键技术和框架

• Rust 语言：项目使用 Rust 作为主要编程语言。
• windows-drivers-rs：这是一个 Rust 库，提供了与 Windows 驱动程序开发相关的功能和接口。
• Windows Driver Kit (WDK)：用于构建和测试 Windows 驱动程序的工具集。
• Clang：用于编译 Rust 代码的工具。
• Cargo：Rust 的包管理器和构建工具。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装和配置之前，请确保您的系统满足以下要求：

• 操作系统：Windows 10 或更高版本。
• 已安装 Visual Studio 或 Visual Studio Code。
• 已安装 Git。

详细安装步骤

步骤 1：安装 Rust

首先，您需要安装 Rust 编程语言。可以通过以下命令安装 Rust：

Invoke-RestMethod -Uri "https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe" -OutFile "$env:USERPROFILE\Downloads\rustup-init.exe"
& "$env:USERPROFILE\Downloads\rustup-init.exe" -y

步骤 2：安装 Clang

接下来，安装 Clang 编译器。可以通过以下命令使用 winget 安装 Clang：

winget install LLVM

步骤 3：安装 Windows 企业版开发工具包 (EWDK)

下载并安装最新版本的 EWDK。您可以从微软官方网站下载 EWDK 的 ISO 镜像，并将其解压到 C:\ewdk 目录。

步骤 4：设置 EWDK 环境

启动 EWDK 环境，运行以下命令：

c:\ewdk\LaunchBuildEnv.cmd

步骤 5：克隆项目仓库

使用 Git 克隆项目仓库到本地：

git clone https://github.com/microsoft/Windows-rust-driver-samples.git

步骤 6：安装依赖项

进入项目目录并安装所需的依赖项：

cd Windows-rust-driver-samples
cargo install cargo-make --no-default-features --features tls-native

步骤 7：构建项目

在 EWDK 开发命令提示符下，运行以下命令构建项目：

cargo make

如果构建成功，将会生成驱动程序的 INF 文件和 CAT 文件，并放置在 Package 文件夹中。

步骤 8：安装驱动程序

在测试计算机上，按照以下步骤安装驱动程序：

1. 将驱动程序包文件夹复制到测试计算机。
2. 安装证书：双击证书文件，选择“本地计算机”，将证书安装到“受信任的根证书颁发机构”和“受信任的发布者”。
3. 使用管理员权限运行以下命令安装驱动程序：

   pnputil.exe /add-driver echo_2.inf /install
   

4. 创建软件设备：

   devgen.exe /add /hardwareid "root\ECHO_2"
   

步骤 9：测试驱动程序

您可以使用 DebugView 工具捕获驱动程序的输出，或者在 Windbg 会话中查看输出。

通过以上步骤，您应该能够成功安装和配置 Windows Rust 驱动程序示例项目。

Windows-rust-driver-samples Rust port of the official Windows Driver Samples on Github. Leverages windows-drivers-rs 项目地址: https://gitcode.com/gh_mirrors/wi/Windows-rust-driver-samples