VMware Tools 升级失败 – VMXNet3 驱动安装超时问题

William
2026-04-30
7:13 上午
评论

今天例行升级时遇到一个比较无谓的的问题——在升级 VMware Tools 的时候，从 12.3.0 升级到 12.5.2 失败了，提示需要手动安装 VMXNet3 驱动。查了一下 VMware KB 429119，竟然原来这是 Windows 系统映像损坏导致的问题，这里分享下记录下。

故障现象还原

1. 升级失败提示

在虚拟机的 Windows 系统中，VMware Tools 升级过程中会弹出以下错误提示：

Setup failed to install the VMXNet3 driver automatically. This driver will have to be installed manually.

2. 关键日志信息

C:\windows\INF\vminst.log 中的错误：

YYYY-MM-DDTHH:MM:SS | tools-build-24964629| I1: Util_GetKeyValueDWORD: Cannot query key value HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\vmxnet3ndis6\DeleteFlag| winerror code 2 (The system cannot find the file specified.)
YYYY-MM-DDTHH:MM:SS | tools-build-24964629| I1: PnpDriverManager::InstallPnPDevices: Inf file C:\Program Files\Common Files\VMware\Drivers\vmxnet3\Win8\vmxnet3.inf was installed as oem4.inf (full path C:\Windows\INF\oem4.inf)
YYYY-MM-DDTHH:MM:SS | tools-build-24964629| I1: PnpDriverManager::InstallPnPDevices: Attempting to install HID0: PCI\VEN_15AD&DEV_07B0&SUBSYS_07B015AD
YYYY-MM-DDTHH:MM:SS | tools-build-24964629| I1: PnpDriverManager::InstallPnPDevices: UpdateDriverForPlugAndPlayDevicesW on ID0 (PCI\VEN_15AD&DEV_07B0&SUBSYS_07B015AD) failed| HRESULT code 0x800705b4 (This operation returned because the timeout period expired.)
YYYY-MM-DDTHH:MM:SS | tools-build-24964629| E1: PnpDriverManager::InstallPnPDevices: Failed to install vmxnet3 driver| winerror code 1460 (This operation returned because the timeout period expired.)

C:\windows\INF\setupapi.dev.log 中的超时信息：

dvi:Install Device: Starting device 'PCI\VEN_15AD&DEV_07B0&SUBSYS_07B015AD&REV_01\FF565000F755B4FE00'. 14:38:41.562
dvi:Install Device: Starting device completed. 14:38:41.625
dvi:Device pending start:
Device has problem: 0x38 (CM_PROB_NEED_CLASS_CONFIG), problem status: 0x00000000.
dvi:{Configure Device - exit(0x00000000)} 14:38:41.625
dvi:Device Status: 0x01806400, Problem: 0x38
dvi:Timed out waiting for device post-install to complete. 14:42:26.643
ndv:Device install failed for device.
ndv:Error 1460: This operation returned because the timeout period expired.

核心原因分析

根据 KB 429119 的解释，这个问题的根本原因是：

Windows 系统映像损坏导致 VMXNet3 驱动安装超时

具体表现为：

- 无法查询 vmxnet3ndis6 服务的 DeleteFlag 注册表项
- 驱动安装过程超时（0x800705b4 错误代码）
- Windows 系统无法完成网络设备类的配置（0x38 问题）

故障排查与解决方法

1. 检查系统文件完整性

# 在管理员命令提示符中运行系统文件检查器
sfc /scannow

# 如果发现问题，尝试修复
DISM /Online /Cleanup-Image /CheckHealth
DISM /Online /Cleanup-Image /RestoreHealth

2. 检查网络设备配置

# 列出网络适配器
Get-NetAdapter

# 检查网络设备状态
Get-NetAdapter -Physical | Select-Object Name, Status, LinkSpeed

# 检查网络设备属性
Get-NetAdapterAdvancedProperty -Name "Ethernet"

3. 手动安装 VMXNet3 驱动

# 尝试手动安装驱动
# 打开设备管理器（devmgmt.msc）
# 找到网络适配器
# 右键点击 VMware VMXNet3 Ethernet Adapter
# 选择“更新驱动程序”
# 浏览到 C:\Program Files\Common Files\VMware\Drivers\vmxnet3 目录
# 选择对应的操作系统版本文件夹（如 Win8 或 Win10）

4. 检查 Windows 更新

# 检查并安装 Windows 更新
Get-WindowsUpdate -AcceptAll -Install -AutoReboot

预防措施

1. 定期维护 Windows 系统

# 定期运行系统文件检查
sfc /scannow

# 优化系统性能
dism /online /cleanup-image /startcomponentcleanup

2. 备份重要数据

# 定期备份系统和数据
wbadmin start backup -backupTarget:: -include:C: -quiet

# 或者使用 PowerShell 进行更详细的备份
Get-PSDrive
New-Item -Path  -ItemType Directory
Copy-Item -Path "C:\Program Files\Common Files\VMware\Drivers" -Destination  -Recurse