Freigeben über


ZwLoadDriver-Funktion (wdm.h)

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)

Weitere Informationen

FltLoadFilter

RtlInitUnicodeString

UNICODE_STRING

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwUnloadDriver