Règle IoctlReqs (kmdf)

  • Article

La règle IoctlReqs spécifie que les demandes IOCTL ne doivent pas être passées à une requête KMDF inappropriée ou à des interfaces de pilote de périphérique (DDIs) d’envoi.

Toutes les demandes présentées à la fonction de rappel d’événement EvtIoDeviceControl du pilote sont garanties comme des requêtes IOCTL. La fonction EvtIoDeviceControl du pilote est déclarée à l’aide de la déclaration de type de rôle de fonction EVT_WDF_IO_QUEUE_IO_DEVICE_CONTROL.

Ces demandes IOCTL ne peuvent pas être envoyées aux DDIs suivants qui sont spécifiques à l’envoi de demandes de lecture, d’écriture ou IOCTL :

WdfUsbTargetPipeSendUrbSynchronously, WdfIoTargetSendReadSynchronously, WdfIoTargetSendWriteSynchronously, WdfIoTargetSendInternalIoctlSynchronously, WdfIoTargetSendInternalIoctlOthersSynchronously, WdfUsbTargetPipeWriteSynchronously, WdfUsbTargetPipeReadSynchronously

Modèle de pilote : KMDF

Comment tester

Au moment de la compilation

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

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 à

WdfIoTargetSendInternalIoctlOthersSynchronouslyWdfIoTargetSendInternalIoctlSynchronouslyWdfIoTargetSendReadSynchronouslyWdfIoTargetSendWriteSynchronouslyWdfUsbTargetPipeReadSynchronouslyWdfUsbTargetPipeSendUrbSynchronouslyWdfUsbTargetPipeWriteSynchronously