ZwUnloadDriver-Funktion (wdm.h)

Die ZwUnloadDriver-Routine entlädt einen Treiber aus dem System. Verwenden Sie diese Routine mit äußerster Vorsicht (siehe Abschnitt "Hinweise " unten).

Syntax

NTSYSAPI NTSTATUS ZwUnloadDriver(
  [in] PUNICODE_STRING DriverServiceName
);

Parameter

[in] DriverServiceName

Zeiger auf eine gezählte Unicode-Zeichenfolge, die einen Pfad zum Registrierungsschlüssel des Treibers angibt, \Registry\Machine\System\CurrentControlSet\Services\<DriverName>wobei DriverName der Name des Treibers ist.

Rückgabewert

ZwUnloadDriver gibt STATUS_SUCCESS oder einen Fehler-NTSTATUS-Wert wie STATUS_INVALID_DEVICE_REQUEST zurück.

Wenn für den in DriverServiceName angegebenen Treiber keine DriverUnload-Rückrufroutine in der DRIVER_OBJECT-Struktur festgelegt ist, gibt ZwUnloadDriver STATUS_INVALID_DEVICE_REQUEST zurück.

Hinweise

ZwUnloadDriver entlädt dynamisch einen Geräte- oder Dateisystemtreiber aus dem derzeit ausgeführten System. Es wird nicht empfohlen, dass ein Treiber ZwUnloadDriver für sich selbst aufruft.

Ein Dateisystemfiltertreiber kann nicht sicher aus einem ausgeführten System entladen werden. Daher sollte ein Filter nur ZwUnloadDriver zu Debugzwecken verwenden. Diese Routine sollte nicht in einer Verkaufsversion des Filters aufgerufen werden.

Wenn DriverName der Name eines PnP-Gerätetreibers ist, gibt ZwUnloadDriver STATUS_INVALID_DEVICE_REQUEST zurück und entlädt den Treiber nicht.

Ein Minifilter sollte FltUnloadFilter anstelle von ZwUnloadDriver verwenden, um einen unterstützenden Minifilter zu entladen.

Wenn der Aufruf der ZwUnloadDriver-Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtUnloadDriver" anstelle von "ZwUnloadDriver" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

FltUnloadFilter

RtlInitUnicodeString

UNICODE_STRING

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen