從傳統 VS2008 + DDKWizard + WinDbg + 虛擬機串口/管道 遷移至 VS2010 + WDK 7600.16385.1 + VirtualKD (含 VirtualDDK) + VMware,實現Visual Studio 內核級原生除錯 (F5 直接中斷、變數監看、呼叫堆疊),大幅提升驅動開發效率。本文記錄完整環境搭建流程、關鍵配置與避坑指南。
| 元件 | 版本 | 下載來源/備註 |
|---|---|---|
| Visual Studio | 2010 SP1 (Professional/Ultimate) | MSDN / Visual Studio Dev Essentials |
| Windows Driver Kit (WDK) | 7600.16385.1 (Win7 RTM) 或 8.0 (Win8) | WDK 7600 支援 Win7/2008R2 目標;WDK 8 支援 Win8/2012。建議 WDK 7600 相容性最廣。 |
| VirtualKD | 2.9+ (含 VirtualDDK) | 官網,開源、免費、支援 VS2010/2012/2013/2015/2017/2019/2022 |
| VMware Workstation | 10.x / 11.x / 12.x / 14.x / 15.x / 16.x / 17.x | Player/Pro 均可,需支援虛擬串口/管道 |
| 目標測試機 (Guest) | Windows 7 x64 / x86 (測試簽名模式) | 啟用測試模式:bcdedit /set testsigning on |
[Host: VS2010 + VirtualKD VS Extension]
│ Named Pipe / TCP (默認 \\.\pipe\kd_)
▼
[Guest: VMware 虛擬機 Windows 7]
│ VirtualKD Client (vmmouse.sys / kdcom.dll 替代)
│ 早期斷點 → 連接 Host VirtualKD Server
▼
[Host: VirtualKD Server (VirtualKD.exe)] ←→ [VS2010 Kernel Debugger Engine]
kdcom.dll (x86) 或 kdcom.dll + vmmouse.sys (x64),實現高速 KD 通訊 (比串口快 50-100x)。VirtualKD.exe → Install Driver → 選擇目標 VMware 虛擬機 .vmx 檔案 → 自動注入 VirtualKD Client 至客體機 (需客體機開機)。
# 以管理員身分執行 CMD
bcdedit /set testsigning on # 允許測試簽名驅動載入
bcdedit /set debug on # 啟用核心除錯 (VirtualKD 會自動設定)
# 重啟客體機
# 驗證 VirtualKD Client 已注入
# 系統管理工具 → 服務 → 應有 "VirtualKD" 服務 (Running)
# 裝置管理員 → 系統裝置 → "VirtualKD Debug Transport" 存在
File → New Project → Driver → VirtualKD Driver (或 WDK → KMDF Driver 後手動套用 VirtualDDK 屬性頁)。DriverEntry、EvtDeviceAdd、EvtIoDeviceControl 等標準 KMDF/WDM 入口點。| 維度 | 傳統 WinDbg + 串口/管道 | VS2010 + VirtualKD |
|---|---|---|
| 除錯介面 | WinDbg 指令列/視窗 (陡峭學習曲線) | VS 原生 IDE (熟悉、直觀、IntelliSense) |
| 通訊速度 | 串口 115200 bps / 管道 ~1-2 Mbps | Named Pipe / TCP ~100-200 Mbps (快 50-100x) |
| 符號/原始碼同步 | 手動 .sympath, .srcpath | 專案原始碼自動同步、PDB 自動載入 |
| 條件中斷/資料監看 | 支援但語法繁瑣 | 原生 VS 體驗 (右鍵 Add Watch, Condition...) |
| 驅動重載/熱更新 | 手動卸載/載入/重啟 | Auto-reload: 建置即自動重載、中斷於 Entry |
| 多核心除錯 | 支援但複雜 | 原生支援多處理器核心切換 |
bcdedit /set debug on 已生效 (bcdedit /enum 查看)。\\.\pipe\kd_、This end is server、Other end is virtual machine、Yield CPU on poll 勾選。Tools → Options → Projects and Solutions → VC++ Directories → Include files / Library files 確認包含 $(WDK7600_INC_PATH), $(WDK7600_LIB_PATH) (VirtualDDK 應自動注入)。bcdedit /set testsigning on、驅動簽名為測試簽名 (VirtualDDK 自動處理)、DriverEntry 回傳 STATUS_SUCCESS、無未解析匯入。VirtualKD 完整支援 VS2017/2019/2022。現代流程:
Configuration Properties → Driver → Target Platform 選擇 Windows 10/11。VirtualKD + VirtualDDK 是 Windows 驅動開發者的「神兵利器」,將核心除錯從神秘黑盒變為熟悉的 IDE 體驗。雖然初期環境搭建需耐心,但長期投資報酬率極高。建議團隊建立標準化環境映像 (Packer + VMware + VirtualKD 預裝),新成員一日即可上手開發。