你好。请问在 PowerShell 中用应用程序打开这个过滤驱动时，返回的具体错误代码和信息是什么？ Windows 通常会记录一个 STATUS_xxx 错误值或 Win32 错误代码。
我编写了一个PCIe switch设备的过滤驱动，但是它会顶替掉原驱动pci.sys，而不是附加在原驱动上
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(19.2, 59%, 11%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3EA%3C/text%3E%3C/svg%3E)
卫平 谢
0
信誉分
我编写了一个PCIe switch设备的过滤驱动，但是它会顶替掉原驱动pci.sys，而不是附加在原驱动上。现象如下图所示，主要代码我也附上了，帮忙检查一下到底是什么问题导致的？
当我安装这个驱动后，用管理员打开powershell终端，调用应用程序打开这个过滤驱动，提示错误：
Windows 开发 | Windows API - Win32
{count} 票
-
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(246.4, 62%, 33%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3ETT%3C/text%3E%3C/svg%3E)
Tom Tran (WICLOUD CORPORATION) 3,320 信誉分 Microsoft 外部员工 仲裁人2025-11-19T02:25:12.6333333+00:00 你好 @卫平 谢 , 感谢你的信息。为了继续定位问题，麻烦你把 PowerShell 的完整错误信息 发我（请直接复制粘贴报错文本）。这将帮助我确定问题的根本原因。
-
Tom Tran (WICLOUD CORPORATION) 3,320 信誉分 Microsoft 外部员工 仲裁人
2025-11-24T03:02:32.8+00:00 你好 @卫平 谢 ,
我只是来确认一下，您的问题是否已经解决了？如果您还有任何疑问，请在下方留言。我很乐意帮您！
-
卫平 谢 0 信誉分
2025-12-06T15:58:16.47+00:00 没有解决。我网上查了一下资料说应用程序只能打开原驱动的接口，是无法打开过滤驱动的，说过滤驱动不应该创建接口？
我的需求是应用程序只需要能够访问读写PCIe switch设备的PCIe配置和读写BAR空间寄存器，因为PCIe switch默认会安装系统自带的pci.sys，这个驱动可以很好的工作，我们不想替换它。是否有更好的解决方案去实现我的需求？我现在就是很迷茫，不知道应该选择什么方案去实现我的需求。感谢您能给我指点方向，谢谢！
-
卫平 谢 0 信誉分
2025-12-08T04:08:51.66+00:00 localHDevice = CreateFile( deviceInterfaceDetailData->DevicePath, GENERIC_READ | GENERIC_WRITE, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED, // 关键：添加重叠I/O标志 NULL ); if (localHDevice == INVALID_HANDLE_VALUE) { printf("CreateFile failed. Error: %d\n", GetLastError()); goto exit; }打印的错误信息：PS E:\Projects2\PciConfig\x64\Debug> .\TestApp.exe
Opening PCIe Filter device...
Looking for MyPciConfig device...
Device path: \?\pci#ven_1412&dev_0010&subsys_00000000&rev_10#4&39ff1125&0&0009#{5c50cd06-c90b-4966-b60a-8f7a0fffa6d4}
CreateFile failed. Error: 1
登录以评论
-
Emmanuel Santana 33,000 信誉分 独立顾问2025-11-18T12:11:51.5766667+00:00 -
Tom Tran (WICLOUD CORPORATION) 3,320 信誉分 Microsoft 外部员工 仲裁人
2025-12-09T06:09:21.9566667+00:00 嗨 @卫平 谢 ,
根据你描述的情况，问题主要有两个：
- INF 文件替换了系统自带的 PCI 驱动（pci.sys），而不是作为过滤驱动附加在它上面，这会破坏总线驱动栈。
- 应用程序尝试用 CreateFile 打开过滤驱动创建的设备接口，但驱动没有处理打开请求，导致 Windows 返回 ERROR_INVALID_FUNCTION。
过滤驱动通常不应该在被过滤的 PCI 设备上发布用户模式接口，正确做法是创建一个独立的控制设备对象供应用访问。
我建议你尝试以下步骤：
1. 修正 INF 文件，让驱动作为过滤驱动而不是功能驱动
老方法：在设备实例键中使用 UpperFilters / LowerFilters。
新方法（Windows 10 1903+）：使用 INF AddFilter 指令 和 INF DDInstall.Filters 部分，保持 pci.sys 作为功能驱动。 参考：安装筛选器驱动程序。
2. 创建控制设备对象供应用程序打开
- 在 KMDF 中调用 WdfControlDeviceInitAllocate 函数 （wdfcontrol.h），设置 SDDL 权限，给它一个 DOS 名称（例如
\\.\MyPciFilter）。 - 应用程序通过这个路径打开设备并使用 IOCTL 通信。 参考：使用控制设备对象。
3. 添加 IOCTL 实现 PCI 访问
- PCI 配置空间：使用 访问 PCI 设备配置空间 或通过 BUS_INTERFACE_STANDARD 结构 (wdm.h) 调用 WdfFdoQueryForInterface 函数 （wdffdo.h）。
- BAR MMIO：在 EVT_WDF_DEVICE_PREPARE_HARDWARE回调函数 （wdfdevice.h） 中遍历资源列表，找到
CmResourceTypeMemory，用 查找和映射硬件资源 映射内存。
4. 确保驱动正确处理打开/关闭请求
注册文件创建回调或默认 I/O 队列，避免 CreateFile 返回错误。 参考：IRP_MJ_CREATE。
这是过滤驱动常见问题，修正 INF 并使用控制设备对象后，可以保留 pci.sys，安全访问 PCI 配置空间和 BAR。
希望这能帮到你！
-
Tom Tran (WICLOUD CORPORATION) 3,320 信誉分 Microsoft 外部员工 仲裁人
2025-12-11T02:53:25.43+00:00 -
Deleted
此评论已被删除，因为违反了我们的行为准则。 在采取措施之前，已通过自动检测手动报告或识别该评论。 有关详细信息，请参阅我们的行为准则。
-
卫平 谢 0 信誉分
2025-12-11T11:04:10.9633333+00:00 我的INF文件上传了，帮忙看一下，现在我安装完后，设备管理器里PCI Express根端口下的设备接口变成1个了，原来是3个的（PCIE上行+2个下行接口）。
安装过滤驱动后的查询结果如下：
PS E:> .\devcon.exe stack "PCI\VEN_1412&DEV_0010"
PCI\VEN_1412&DEV_0010&SUBSYS_00000000&REV_10\4&39FF1125&0&0009
Name: HXPciDriver Device Setup Class: {4d36e97d-e325-11ce-bfc1-08002be10318} System Upper filters: HXPciDriver Controlling service: HXPciDriverROOT\SYSTEM\0002
Name: HXPciDriver Device Setup Class: {4d36e97d-e325-11ce-bfc1-08002be10318} System Upper filters: HXPciDriver Controlling service: HXPciDriver2 matching device(s) found.
PS E:> .\devcon.exe driverfiles "PCI\VEN_1412&DEV_0010*"
PCI\VEN_1412&DEV_0010&SUBSYS_00000000&REV_10\4&39FF1125&0&0009
Name: HXPciDriver Device Driver installed from C:\WINDOWS\INF\oem20.inf [HXPciDriver_Device]. 2 file(s) used by driver: C:\WINDOWS\System32\DriverStore\FileRepository\hxpcidriver.inf_amd64_d46d4f77baef601e\HXPciDriver.sys C:\WINDOWS\system32\DRIVERS\pci.sysROOT\SYSTEM\0002
Name: HXPciDriver Device Driver installed from C:\WINDOWS\INF\oem20.inf [HXPciDriver_Device]. 2 file(s) used by driver: C:\WINDOWS\System32\DriverStore\FileRepository\hxpcidriver.inf_amd64_d46d4f77baef601e\HXPciDriver.sys C:\WINDOWS\system32\DRIVERS\pci.sys2 matching device(s) found.
PS E:>
-
Tom Tran (WICLOUD CORPORATION) 3,320 信誉分 Microsoft 外部员工 仲裁人
2025-12-12T07:47:31.95+00:00 嗨 @卫平 谢 ,
感谢您提供INF文件和详细的日志信息。我已经仔细分析了您的配置，认为已经找到了您遇到问题的根本原因。
根据您的描述和安装日志，目前您的驱动被当作**功能驱动（functional driver）**安装到了PCIe交换芯片设备上，而不是作为过滤驱动（filter driver）附加。这会导致Windows把您的驱动当作该设备的主要驱动，从而破坏了正常的PCIe设备堆栈。这也是为什么您在PCI Express根端口下只看到一个设备接口（而不是原本的三个），并且下游设备可能无法正常显示或工作。
这种情况在开发PCI设备（尤其是桥或交换芯片）的过滤驱动时非常常见。您的INF文件中包含了类似
Include=pci.inf和Needs=PCI_BRIDGE这样的语句，这些本来是功能驱动用的，而不是过滤驱动。结果就是，您的驱动替换了系统默认的pci.sys，而不是和它并存。建议您尝试以下方法：
- 卸载当前驱动，并恢复设备默认的pci.sys驱动。 这样可以恢复正常的设备堆栈，丢失的接口也会重新出现。
- 修改您的INF文件，仅注册为过滤驱动。 具体来说，删除所有
Include=pci.inf和Needs=PCI_BRIDGE相关的行，改用UpperFilters注册表项（如果目标系统是Windows 10 1903及以上，也可以用AddFilter指令）。这样您的驱动就会作为过滤驱动附加，而不会干扰默认的总线驱动。 - 修正INF并重新安装后， 您应该能在PCI Express根端口下看到预期数量的设备接口，系统默认的PCI总线驱动（pci.sys）也会继续作为主驱动。
- 如果您的应用需要与过滤驱动通信，建议在驱动中创建一个独立的控制设备对象（control device object）用于用户态访问，而不是直接打开被过滤的PCI设备。
下面是一个仅作为过滤驱动安装的INF模板，供您参考：
[Version] Signature = "$WINDOWS NT$" Class = System ClassGuid = {4d36e97d-e325-11ce-bfc1-08002be10318} Provider = %ManufacturerName% CatalogFile = HXPciDriver.cat DriverVer = 12/12/2025,1.0.0.0 PnpLockdown = 1 [DestinationDirs] DefaultDestDir = 12 [SourceDisksNames] 1 = %DiskName% [SourceDisksFiles] HXPciDriver.sys = 1 [Manufacturer] %ManufacturerName% = Models,NT$ARCH$ [Models.NT$ARCH$] %HXPciDriver.DeviceDesc% = HXPciDriver_Install, PCI\VEN_1412&DEV_0010&SUBSYS_00000000&REV_10 %HXPciDriver.DeviceDesc% = HXPciDriver_Install, PCI\VEN_1412&DEV_0010&SUBSYS_00000000 %HXPciDriver.DeviceDesc% = HXPciDriver_Install, PCI\VEN_1412&DEV_0010 [HXPciDriver_Install.NT] CopyFiles = HXPciDriver_CopyFiles [HXPciDriver_Install.NT.HW] AddReg = HXPciDriver_AddReg [HXPciDriver_Install.NT.Services] AddService = HXPciDriver, 0x00000002, HXPciDriver_Service_Inst [HXPciDriver_Install.NT.Wdf] KmdfService = HXPciDriver, HXPciDriver_WdfSect [HXPciDriver_CopyFiles] HXPciDriver.sys [HXPciDriver_Service_Inst] DisplayName = %HXPciDriver.SVCDESC% ServiceType = 1 StartType = 3 ErrorControl = 1 ServiceBinary = %12%\HXPciDriver.sys [HXPciDriver_WdfSect] KmdfLibraryVersion = 1.33 [HXPciDriver_AddReg] HKR,,"UpperFilters",0x00010008,"HXPciDriver" [Strings] ManufacturerName = "<HXQ Co.,Ltd.>" DiskName = "HXPciDriver Installation Disk" HXPciDriver.DeviceDesc = "HXPciDriver Device" HXPciDriver.SVCDESC = "HXPciDriver Service"
更多关于如何编写过滤驱动INF文件的细节，您可以参考微软官方文档：安装筛选器驱动程序 以及 INF AddFilter 指令。
希望这能帮到你！
-
卫平 谢 0 信誉分
2025-12-12T10:20:29.85+00:00 非常感谢您的回复，我按照您给的INF文件修改后，仍然没有正确被安装。我将INF和安装日志打印上传，帮忙看看。谢谢！
;
; HXPciDriver.inf
;
[Version]
Signature = "$WINDOWS NT$"
Class = System ; TODO: specify appropriate Class
ClassGuid = {4d36e97d-e325-11ce-bfc1-08002be10318} ; TODO: specify appropriate ClassGuid
Provider = %ManufacturerName%
CatalogFile = HXPciDriver.cat
DriverVer = 12/12/2025,1.0.0.0; TODO: set DriverVer in stampinf property pages
PnpLockdown = 1
[DestinationDirs]
DefaultDestDir = 12
[SourceDisksNames]
1 = %DiskName%
[SourceDisksFiles]
HXPciDriver.sys = 1
;*****************************************
; Install Section
;*****************************************
[Manufacturer]
%ManufacturerName% = Models,NT$ARCH$ ; %13% support introduced in build 16299
[Models.NT$ARCH$]
%HXPciDriver.DeviceDesc% = HXPciDriver_Install, PCI\VEN_1412&DEV_0010&SUBSYS_00000000&REV_10 ; TODO: edit hw-id
%HXPciDriver.DeviceDesc% = HXPciDriver_Install, PCI\VEN_1412&DEV_0010&SUBSYS_00000000
%HXPciDriver.DeviceDesc% = HXPciDriver_Install, PCI\VEN_1412&DEV_0010
[HXPciDriver_Install.NT]
CopyFiles = HXPciDriver_CopyFiles
[HXPciDriver_Install.NT.HW]
AddReg = HXPciDriver_AddReg
;-------------- Service installation
[HXPciDriver_Install.NT.Services]
AddService = HXPciDriver, 0x00000002, HXPciDriver_Service_Inst
[HXPciDriver_Install.NT.Wdf]
KmdfService = HXPciDriver, HXPciDriver_WdfSect
[HXPciDriver_CopyFiles]
HXPciDriver.sys
; -------------- HXPciDriver driver install sections
[HXPciDriver_Service_Inst]
DisplayName = %HXPciDriver.SVCDESC%
ServiceType = 1 ; SERVICE_KERNEL_DRIVER
StartType = 3 ; SERVICE_DEMAND_START
ErrorControl = 1 ; SERVICE_ERROR_NORMAL
ServiceBinary = %12%\HXPciDriver.sys
[HXPciDriver_WdfSect]
KmdfLibraryVersion = 1.33
[HXPciDriver_AddReg]
HKR,,"UpperFilters",0x00010008,"HXPciDriver"
[Strings]
;SPSVCINST_ASSOCSERVICE = 0x00000002
ManufacturerName = "<HXQ Co.,Ltd.>" ;TODO: Replace with your manufacturer name
DiskName = "HXPciDriver Installation Disk"
HXPciDriver.DeviceDesc = "HXPciDriver Device"
HXPciDriver.SVCDESC = "HXPciDriver Service"
安装打印：
PS E:> .\devcon.exe stack "PCI\VEN_1412&DEV_0010"
PCI\VEN_1412&DEV_0010&SUBSYS_00000000&REV_10\4&39FF1125&0&0009
Name: PCI Express Setup Class: {4d36e97d-e325-11ce-bfc1-08002be10318} System Controlling service: pciPCI\VEN_1412&DEV_0010&SUBSYS_00000000&REV_10\5&1CD3F91A&9B&200009
Name: PCI Express Setup Class: {4d36e97d-e325-11ce-bfc1-08002be10318} System Controlling service: pciPCI\VEN_1412&DEV_0010&SUBSYS_00000000&REV_10\5&1CD3F91A&9B&400009
Name: PCI Express Setup Class: {4d36e97d-e325-11ce-bfc1-08002be10318} System Controlling service: pci3 matching device(s) found.
PS E:>
PS E:> .\devcon.exe install 'E:\Projects2\HXPciDriver\x64\Debug\HXPciDriver\HXPciDriver.inf' "PCI\VEN_1412&DEV_0010"
Device node created. Install is complete when drivers are installed...
Updating drivers for PCI\VEN_1412&DEV_0010 from E:\Projects2\HXPciDriver\x64\Debug\HXPciDriver\HXPciDriver.inf.
Drivers installed successfully.
PS E:>
PS E:> .\devcon.exe stack "PCI\VEN_1412&DEV_0010"
PCI\VEN_1412&DEV_0010&SUBSYS_00000000&REV_10\4&39FF1125&0&0009
Name: HXPciDriver Device Setup Class: {4d36e97d-e325-11ce-bfc1-08002be10318} System Upper filters: HXPciDriver Controlling service: HXPciDriverROOT\SYSTEM\0002
Name: HXPciDriver Device Setup Class: {4d36e97d-e325-11ce-bfc1-08002be10318} System Upper filters: HXPciDriver Controlling service: HXPciDriver2 matching device(s) found.
PS E:> .\devcon.exe driverfiles "PCI\VEN_1412&DEV_0010*"
PCI\VEN_1412&DEV_0010&SUBSYS_00000000&REV_10\4&39FF1125&0&0009
Name: HXPciDriver Device Driver installed from C:\WINDOWS\INF\oem14.inf [HXPciDriver_Install]. 1 file(s) used by driver: C:\WINDOWS\system32\DRIVERS\HXPciDriver.sysROOT\SYSTEM\0002
Name: HXPciDriver Device Driver installed from C:\WINDOWS\INF\oem14.inf [HXPciDriver_Install]. 1 file(s) used by driver: C:\WINDOWS\system32\DRIVERS\HXPciDriver.sys2 matching device(s) found.
PS E:>
-
Tom Tran (WICLOUD CORPORATION) 3,320 信誉分 Microsoft 外部员工 仲裁人
2025-12-12T10:37:12.1333333+00:00 嗨 @卫平 谢 ,
感谢您提供更新后的 INF 文件和安装日志。我看到您已经做得很接近正确配置，但还有一个关键细节导致您的驱动没有作为真正的过滤驱动（filter driver）被安装。
您当前使用的命令：
-
devcon install HXPciDriver.inf "PCI\VEN_1412&DEV_0010"
这个命令会创建一个新的设备节点，并将您的驱动作为该设备的主要（功能）驱动进行安装。这就是为什么安装后，“Controlling service” 变成了
HXPciDriver而不是pci.sys。结果就是，您的驱动替换了系统默认的 PCI 总线驱动，导致 PCIe 拓扑异常。
我建议您尝试以下步骤：
- 卸载当前驱动，并恢复该设备的默认
pci.sys驱动。 您可以在设备管理器中回滚驱动，或者卸载设备后重新扫描硬件来实现。 - 用正确的方法安装过滤驱动：
- 在设备管理器中，右键点击您的设备，选择“更新驱动程序”，并指定您的 INF 文件。
- 或者，使用如下命令（不要再用
devcon install）：devcon update HXPciDriver.inf "PCI\VEN_1412&DEV_0010"这个命令会更新现有设备，并将您的驱动作为 UpperFilter 添加，而不会替换pci.sys。
- 或者，使用如下命令（不要再用
- 验证结果：
- 执行
devcon stack "PCI\VEN_1412&DEV_0010" - 您应该能看到
pci仍然是 Controlling service，HXPciDriver被列为 Upper filter。- 在驱动文件列表中，应该同时看到
pci.sys和HXPciDriver.sys。
- 在驱动文件列表中，应该同时看到
INF 文件的小修正建议： 在
[DestinationDirs]部分，请使用DefaultDestDir = 12，不要用Default = 12，这样更规范。
希望这能帮到你！
-
登录以评论