WinCDEmu 技术文档

WinCDEmu 技术文档

WinCDEmu 项目地址: https://gitcode.com/gh_mirrors/wi/WinCDEmu

1. 安装指南

1.1 环境准备

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

• 操作系统: Windows 7 或更高版本。
• 开发工具: Visual Studio 2010 至 2015。
• WDK 7.x: Windows Driver Kit 7.x。
• WTL 8.0: Windows Template Library 8.0。

1.2 下载项目

首先，您需要从 GitHub 下载以下三个项目到同一个目录中：

• WinCDEmu
• BazisLib
• STLPort-kernel

1.3 设置环境变量

在下载完成后，您需要设置以下环境变量：

• BZSLIB_PATH: 指向 BazisLib 目录。
• STLPORT_PATH: 指向 STLPort 目录。
• WDK7PATH: 指向 WDK 7.x 的安装目录。
• WTL_PATH: 指向 WTL 8.0 的解压目录。

1.4 安装 WDK 7.x 和 WTL 8.0

• WDK 7.x: 下载并安装 WDK 7.x，并确保 WDK7PATH 环境变量指向其安装目录。
• WTL 8.0: 下载 WTL 8.0 并解压，设置 WTL_PATH 环境变量指向解压后的目录。

2. 项目的使用说明

2.1 打开项目

在 Visual Studio 中打开 WinCDEmu.sln 解决方案文件。

2.2 构建项目

1. 首先构建内核模式（kernel-mode）的发布配置。
2. 然后构建用户模式（user-mode）的发布配置。

2.3 获取二进制文件

构建完成后，生成的二进制文件将保存在 AllModules 目录中。

3. 项目 API 使用文档

WinCDEmu 项目主要通过内核模式和用户模式的驱动程序来实现虚拟光驱的功能。以下是一些关键 API 的使用说明：

3.1 内核模式 API

• VirtualDriveManager: 管理虚拟光驱的创建和销毁。
• VirtualCDCtl: 控制虚拟光驱的行为，如挂载和卸载 ISO 文件。

3.2 用户模式 API

• WinCDEmuContextMenu: 提供右键菜单选项，方便用户快速挂载和卸载 ISO 文件。

4. 项目安装方式

4.1 手动安装

1. 下载并解压 WinCDEmu 项目。
2. 按照上述步骤设置环境变量并构建项目。
3. 将生成的二进制文件复制到系统目录（如 C:\Windows\System32）。

4.2 自动安装

WinCDEmu 项目提供了一个安装程序，您可以通过运行 InstallerStub 目录中的安装程序来自动安装项目。

---

通过以上步骤，您可以成功安装并使用 WinCDEmu 项目。如果在使用过程中遇到任何问题，请参考项目的 GitHub 页面或联系开发者获取支持。

WinCDEmu 项目地址: https://gitcode.com/gh_mirrors/wi/WinCDEmu