Funzione IoDeleteController (ntddk.h)
La routine IoDeleteController rimuove un determinato oggetto controller dal sistema, ad esempio quando il driver che lo ha creato viene scaricato.
Sintassi
void IoDeleteController(
[in] PCONTROLLER_OBJECT ControllerObject
);
Parametri
[in] ControllerObject
Puntatore all'oggetto controller da rilasciare.
Valore restituito
nessuno
Osservazioni
IoDeleteController dealloca la memoria per l'oggetto controller, inclusa l'estensione del controller.
Questa routine deve essere chiamata quando un driver che ha creato un oggetto controller viene scaricato o quando il driver rileva un errore irreversibile durante l'avvio del dispositivo, ad esempio non è in grado di inizializzare correttamente un dispositivo fisico.
Un driver deve rilasciare determinate risorse per cui il driver ha fornito spazio di archiviazione nell'estensione del controller prima di chiamare IoDeleteController. Ad esempio, se il driver archivia il puntatore agli oggetti interrupt nell'estensione del controller, deve chiamare IoDisconnectInterrupt prima di IoDeleteController.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | ntddk.h (include Ntddk.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |