TargetRelationNeedsRef 规则 (wdm)

TargetRelationNeedsRef 规则指定在处理 TargetDeviceRelation 查询时，驱动程序的 DispatchPnP 例程调用以下函数之一来引用子设备的 PDO：

• ObReferenceObject

• ObReferenceObjectByHandle

• ObReferenceObjectByPointer

仅当驱动程序通过将指针设置为 Irp->IoStatus.Information 新的非 NULL 值来完成 IRP 时，此规则才适用。 当驱动程序将 IRP 传递给较低驱动程序时，不会应用它。

此规则未指定限定为 的有效值 Irp->IoStatus.Information的内容。 仅当驱动程序更改值且新值不为 NULL 时，此规则才适用。 有效值是指向包含所请求关系信息的DEVICE_RELATIONS结构的指针。

此规则仅适用于总线驱动程序。

驱动程序模型：WDM

如何测试

编译时
运行 静态驱动程序验证程序 并指定 TargetRelationNeedsRef 规则。 使用以下步骤运行代码分析： 准备代码 (使用角色类型声明) 。 运行静态驱动程序验证程序。 查看和分析结果。 有关详细信息，请参阅 使用静态驱动程序验证程序查找驱动程序中的缺陷。

适用于

IoCallDriverObReferenceObjectByHandleObReferenceObjectByPointerPoCallDriver

另请参阅

DanglingDeviceObjectReference