Функция IoDeleteController (ntddk.h)
Подпрограмма ioDeleteController удаляет объект контроллера из системы, например при выгрузке драйвера.
Синтаксис
void IoDeleteController(
[in] PCONTROLLER_OBJECT ControllerObject
);
Параметры
[in] ControllerObject
Указатель на освобожденный объект контроллера.
Возвращаемое значение
Никакой
Замечания
IoDeleteController освобождает память для объекта контроллера, включая расширение контроллера.
Эта подпрограмма должна вызываться при выгрузке драйвера, создавшего объект контроллера, или при возникновении неустранимой ошибки во время запуска устройства, например невозможности правильной инициализации физического устройства.
Драйвер должен освободить определенные ресурсы, для которых драйвер предоставил хранилище в расширении контроллера, прежде чем вызывать IoDeleteController. Например, если драйвер сохраняет указатель на его объекты прерывания в расширении контроллера, он должен вызывать IoDisconnectInterrupt перед IoDeleteController.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 2000. |
| целевая платформа | Всеобщий |
| заголовка | ntddk.h (include Ntddk.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| правил соответствия DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |