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) |