IRP_MN_CANCEL_REMOVE_DEVICE
Tous les pilotes PnP doivent gérer cette IRP.
Valeur
0x03
Code majeur
Date d’envoi
Le gestionnaire PnP envoie cette IRP pour informer les pilotes d’un appareil que l’appareil ne sera pas supprimé.
Le gestionnaire PnP envoie cette IRP à IRQL PASSIVE_LEVEL dans le contexte d’un thread système.
Paramètres d’entrée
Aucun
Paramètres de sortie
None
Bloc d’état E/S
Un pilote doit définir Irp-IoStatus.Status> sur STATUS_SUCCESS pour cette IRP. Si un pilote échoue à cette IRP, l’appareil est laissé dans un état incohérent.
Opération
Cette IRP doit d’abord être gérée par le pilote de bus parent pour un appareil, puis par chaque pilote supérieur dans la pile de périphériques.
En réponse à cette IRP, les pilotes retournent l’appareil à l’état dans lequel il se trouvait avant de recevoir la demande de IRP_MN_QUERY_REMOVE_DEVICE .
Si l’appareil est déjà démarré lorsque le pilote reçoit cette IRP, il définit simplement status de réussite et transmet l’IRP au pilote suivant (ou termine l’IRP si le pilote est un pilote de bus). Pour une telle IRP d’annulation/suppression, une fonction ou un pilote de filtre n’a pas besoin de définir une routine d’achèvement. L’appareil peut ne pas être dans l’état de suppression en attente, car, par exemple, le pilote a échoué lors de la IRP_MN_QUERY_REMOVE_DEVICE précédente.
Le gestionnaire PnP appelle les rappels de notification EventCategoryTargetDeviceChange avec GUID_TARGET_DEVICE_REMOVE_CANCELLED une fois la demande IRP_MN_CANCEL_REMOVE_DEVICE terminée. Ces rappels ont été enregistrés sur l’appareil en appelant IoRegisterPlugPlayNotification. Le gestionnaire PnP appelle également tous les composants en mode utilisateur inscrits pour notification sur l’appareil en appelant RegisterDeviceNotification.
Si un système de fichiers est monté sur l’appareil, il doit annuler toutes les opérations qu’il a effectuées en réponse à la notification de suppression de requête.
Consultez Plug-and-Play pour obtenir des informations détaillées sur la gestion des runtimes d’intégration de suppression et pour connaître les règles générales de gestion de tous les Plug-and-Play les IRP mineurs.
Envoi de cette IRP
Réservé pour le système. Les pilotes ne doivent pas envoyer cette IRP.
Spécifications
En-tête |
Wdm.h (inclure Wdm.h, Ntddk.h ou Ntifs.h) |