InitFreeNull 规则 (kmdf)

InitFreeNull 规则指定不能通过使用指向WDFDEVICE_INIT结构的 NULL 指针来调用作为参数接收PWDFDEVICE_INIT的 DDI。

框架提供的方法初始化 WDFDEVICE_INIT 结构。 当驱动程序调用 WdfDeviceCreate 以创建 (FDO) 的功能设备对象或 (PDO) 的物理设备对象时, WdfDeviceCreate 方法会将第一个参数设置为 NULL (如果成功)。

如果驱动程序在调用设备对象初始化方法或 WdfDeviceCreate 时遇到错误,则驱动程序必须调用 WdfDeviceInitFree。 成功调用 WdfDeviceInitFree 后,应将 指向 WDFDEVICE_INIT 结构的指针设置为 NULL (PWDFDEVICE_INIT=NULL) 。

驱动程序模型:KMDF

如何测试

编译时

运行 静态驱动程序验证程序 并指定 InitFreeNull 规则。

使用以下步骤运行代码分析:
  1. 准备代码 (使用角色类型声明) 。
  2. 运行静态驱动程序验证程序。
  3. 查看和分析结果。

有关详细信息,请参阅 使用静态驱动程序验证程序查找驱动程序中的缺陷

适用于

WdfDeviceCreateWdfDeviceInitAssignNameWdfDeviceInitAssignSDDLStringWdfDeviceInitAssignWdmIrpPreprocessCallbackWdfDeviceInitFreeWdfDeviceInitRegisterPnpStateChangeCallbackWdfDeviceInitRegisterPowerPolicyStateChangeCallbackWdfDeviceInitRegisterPowerStateChangeCallbackWdfPdoInitAddCompatibleIDWdfPdoInitAddDeviceTextWdfPdoInitAddHardwareIDWdfPdoInitAssignDeviceIDWdfPdoInitAssignInstanceIDWdfPdoInitAssignRawDevice

另请参阅

InitFreeDeviceCallbackInitFreeDeviceCreateInitFreeDeviceCreateType2PdoInitFreeDeviceCreateType2InitFreeDeviceCreateType4PdoInitFreeDeviceCallbackPdoInitFreeDeviceCreateType4