Fonction IoDeleteController (ntddk.h)
La routine IoDeleteController supprime un objet contrôleur donné du système, par exemple lorsque le pilote créé est déchargé.
Syntaxe
void IoDeleteController(
[in] PCONTROLLER_OBJECT ControllerObject
);
Paramètres
[in] ControllerObject
Pointeur vers l’objet contrôleur à libérer.
Valeur de retour
Aucun
Remarques
IoDeleteController désalloue la mémoire de l’objet contrôleur, y compris l’extension du contrôleur.
Cette routine doit être appelée lorsqu’un pilote qui a créé un objet de contrôleur est déchargé ou lorsque le pilote rencontre une erreur irrécupérable lors du démarrage de l’appareil, par exemple l’impossibilité d’initialiser correctement un appareil physique.
Un pilote doit libérer certaines ressources pour lesquelles le pilote a fourni un stockage dans son extension de contrôleur avant d’appeler IoDeleteController. Par exemple, si le pilote stocke le pointeur vers ses objets d’interruption dans l’extension du contrôleur, il doit appeler IoDisconnectInterrupt avant IoDeleteController.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Ntddk.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |