Règle TargetRelationNeedsRef (wdm)

  • Article

La règle TargetRelationNeedsRef spécifie que lors du traitement d’une requête TargetDeviceRelation , la routine DispatchPnP du pilote appelle l’une des fonctions suivantes pour référencer le PDO de l’appareil enfant :

Cette règle s’applique uniquement lorsque le pilote termine l’IRP en définissant le Irp->IoStatus.Information pointeur vers une nouvelle valeur non NULL . Elle n’est pas appliquée lorsque le conducteur transmet l’IRP à un pilote inférieur.

Cette règle ne spécifie pas ce qui est qualifié de valeur valide pour Irp->IoStatus.Information. Cette règle s’applique uniquement lorsque le pilote modifie la valeur et que la nouvelle valeur n’est pas NULL. Une valeur valide est un pointeur vers une structure de DEVICE_RELATIONS qui contient les informations de relations demandées.

Cette règle s’applique uniquement aux pilotes de bus.

Modèle de pilote : WDM

Comment tester

Au moment de la compilation

Exécutez Static Driver Verifier et spécifiez la règle TargetRelationNeedsRef .

Utilisez les étapes suivantes pour exécuter l’analyse de votre code :
  1. Préparez votre code (utilisez les déclarations de type).
  2. Exécutez le vérificateur de pilote statique.
  3. Affichez et analysez les résultats.

Pour plus d’informations, consultez Utilisation du vérificateur de pilote statique pour rechercher des défauts dans les pilotes.

S’applique à

IoCallDriverObReferenceObjectByHandleObReferenceObjectByPointerPoCallDriver

Voir aussi

DanglingDeviceObjectReference