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)