ioDeleteController 函式 (ntddk.h)
IoDeleteController 例程會從系統移除指定的控制器物件,例如,當建立它的驅動程式正在卸除時。
語法
void IoDeleteController(
[in] PCONTROLLER_OBJECT ControllerObject
);
參數
[in] ControllerObject
要釋放之控制器物件的指標。
傳回值
無
備註
IoDeleteController 會解除分配控制器對象的記憶體,包括控制器擴充功能。
當建立控制器對象的驅動程式正在卸除,或驅動程式在裝置啟動期間遇到嚴重錯誤時,例如無法正確初始化實體裝置時,必須呼叫此例程。
驅動程式必須先釋放驅動程式在其控制器擴充功能中提供記憶體的特定資源,才能呼叫 IoDeleteController。 例如,如果驅動程式將其中斷物件的指標儲存在控制器擴充功能 () ,它就必須在IoDeleteController之前呼叫IoDisconnectInterrupt。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | Universal |
標頭 | ntddk.h (包含 Ntddk.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 IrqlIoPassive4 (wdm) 、 PowerIrpDDis (wdm) |