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)

Vedi anche

IoCreateController

IoDisconnectInterrupt