Freigeben über


TargetRelationNeedsRef-Regel (wdm)

Die TargetRelationNeedsRef-Regel gibt an, dass die DispatchPnPnP-Routine des Treibers beim Verarbeiten einer TargetDeviceRelation-Abfrage eine der folgenden Funktionen aufruft, um auf die PDO des untergeordneten Geräts zu verweisen:

Diese Regel gilt nur, wenn der Treiber die IRP durch Festlegen des Irp->IoStatus.Information Zeigers auf einen neuen Wert ohne NULL abschließt. Es wird nicht angewendet, wenn der Treiber die IRP an einen niedrigeren Treiber übergibt.

Diese Regel gibt nicht an, was als gültiger Wert für Irp->IoStatus.Informationqualifiziert ist. Diese Regel gilt nur, wenn der Treiber den Wert ändert und der neue Wert nicht NULL ist. Ein gültiger Wert ist ein Zeiger auf eine DEVICE_RELATIONS Struktur, die die angeforderten Beziehungsinformationen enthält.

Diese Regel gilt nur für Busfahrer.

Treibermodell: WDM

So führen Sie einen Test durch

Beim Kompilieren:

Führen Sie static Driver Verifier aus , und geben Sie die TargetRelationNeedsRef-Regel an.

Gehen Sie folgendermaßen vor, um Ihren Code zu analysieren:
  1. Bereiten Sie den Code vor (verwenden Sie Rollentypdeklarationen).
  2. Führen Sie Static Driver Verifier aus.
  3. Überprüfen und analysieren Sie die Ergebnisse.

Weitere Informationen finden Sie unter Verwenden der statischen Treiberüberprüfung, um Fehler in Treibern zu finden.

Gilt für:

IoCallDriverObReferenceObjectByHandleObReferenceObjectByPointerPoCallDriver

Weitere Informationen

DanglingDeviceObjectReference