The IoDeleteController routine removes a given controller object from the system, for example, when the driver that created it is being unloaded.
void IoDeleteController( PCONTROLLER_OBJECT ControllerObject );
Pointer to the controller object to be released.
IoDeleteController deallocates the memory for the controller object, including the controller extension.
This routine must be called when a driver that created a controller object is being unloaded or when the driver encounters a fatal error during device start-up, such as being unable to properly initialize a physical device.
A driver must release certain resources for which the driver supplied storage in its controller extension before it calls IoDeleteController. For example, if the driver stores the pointer to its interrupt object(s) in the controller extension, it must call IoDisconnectInterrupt before IoDeleteController.
|Minimum supported client||Available starting with Windows 2000.|
|Header||ntddk.h (include Ntddk.h)|
|DDI compliance rules||IrqlIoPassive4, PowerIrpDDis, HwStorPortProhibitedDDIs|