ZwUnloadDriver 函式 (wdm.h)
ZwUnloadDriver 例程會從系統卸除驅動程式。 Use this routine with extreme caution (see the Remarks section below).
語法
NTSYSAPI NTSTATUS ZwUnloadDriver(
[in] PUNICODE_STRING DriverServiceName
);
參數
[in] DriverServiceName
計數 Unicode 字串的指標，指定驅動程式登錄機碼的路徑， \Registry\Machine\System\CurrentControlSet\Services\<DriverName>其中 DriverName 是驅動程式的名稱。
傳回值
ZwUnloadDriver 會傳回STATUS_SUCCESS或錯誤 NTSTATUS 值，例如 STATUS_INVALID_DEVICE_REQUEST。
如果 DriverServiceName 中指定的驅動程式在其DRIVER_OBJECT結構中未設定 DriverUnload 回呼例程，ZwUnloadDriver 會傳回STATUS_INVALID_DEVICE_REQUEST。
備註
ZwUnloadDriver 會從目前執行中的系統動態卸載裝置或文件系統驅動程式。 不建議驅動程式本身呼叫 ZwUnloadDriver 。
檔系統篩選驅動程式無法安全地從執行中的系統卸除。 因此，篩選應該只使用 ZwUnloadDriver 進行偵錯。 它不應該在篩選的零售版本中呼叫此例程。
如果 DriverName 是 PnP 設備驅動器的名稱， ZwUnloadDriver 會傳回STATUS_INVALID_DEVICE_REQUEST，而且不會卸除驅動程式。
迷你篩選應該使用 FltUnloadFilter ，而不是 ZwUnloadDriver 來卸除支援的迷你篩選。
如果使用者模式中發生 ZwUnloadDriver 函 式的呼叫，您應該使用名稱 「NtUnloadDriver」，而不是 「ZwUnloadDriver」。。
針對來自內核模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本會以處理和解譯輸入參數的方式，以不同的方式運作。 如需 例程 NtXxx 和 ZwXxx 版本之間關聯性的詳細資訊，請參閱 使用原生系統服務例程的 Nt 和 Zw 版本。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm) |