ZwLoadDriver-Funktion (wdm.h)

Artikel
02/27/2024

Die ZwLoadDriver-Routine lädt einen Treiber in das System.

Syntax

NTSYSAPI NTSTATUS ZwLoadDriver(
  [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

ZwLoadDriver gibt STATUS_SUCCESS oder einen entsprechenden Fehler NTSTATUS-Wert zurück.

Hinweise

ZwLoadDriver lädt dynamisch einen Geräte- oder Dateisystemtreiber in das derzeit ausgeführte System.

Wenn das System im abgesicherten Modus ausgeführt wird und der Treiber nicht geladen werden kann, weil er nicht in der Liste des abgesicherten Modus enthalten ist, gibt ZwLoadDriver STATUS_SUCCESS zurück.

Ein Minifilter sollte FltLoadFilter anstelle von ZwLoadDriver verwenden, um einen unterstützenden Minifilter zu laden.

Wenn der Aufruf der ZwLoadDriver-Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtLoadDriver" anstelle von "ZwLoadDriver" 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)