Función IoDeleteController (ntddk.h)

  • Artículo

La rutina IoDeleteController quita un objeto de controlador determinado del sistema, por ejemplo, cuando se descarga el controlador que lo creó.

Sintaxis

void IoDeleteController(
  [in] PCONTROLLER_OBJECT ControllerObject
);

Parámetros

[in] ControllerObject

Puntero al objeto de controlador que se va a liberar.

Valor devuelto

None

Observaciones

IoDeleteController desasigna la memoria del objeto de controlador, incluida la extensión del controlador.

Se debe llamar a esta rutina cuando se descarga un controlador que creó un objeto de controlador o cuando el controlador encuentra un error irrecuperable durante el inicio del dispositivo, por ejemplo, no se puede inicializar correctamente un dispositivo físico.

Un controlador debe liberar determinados recursos para los que el controlador proporcionó almacenamiento en su extensión del controlador antes de llamar a IoDeleteController. Por ejemplo, si el controlador almacena el puntero a sus objetos de interrupción en la extensión del controlador, debe llamar a IoDisconnectInterrupt antes de IoDeleteController.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Encabezado ntddk.h (incluya Ntddk.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm)

Consulte también

IoCreateController

IoDisconnectInterrupt