Fonction ZwLoadDriver (wdm.h)

  • Article

La routine ZwLoadDriver charge un pilote dans le système.

Syntaxe

NTSYSAPI NTSTATUS ZwLoadDriver(
  [in] PUNICODE_STRING DriverServiceName
);

Paramètres

[in] DriverServiceName

Pointeur vers une chaîne Unicode comptée qui spécifie un chemin d’accès à la clé de Registre du pilote, \Registry\Machine\System\CurrentControlSet\Services\<DriverName>, où <DriverName> est le nom du pilote.

Valeur retournée

ZwLoadDriver retourne STATUS_SUCCESS ou une valeur NTSTATUS d’erreur appropriée.

Remarques

ZwLoadDriver charge dynamiquement un pilote de système de fichiers ou d’appareil dans le système en cours d’exécution.

Si le système s’exécute en mode sans échec et que le pilote ne parvient pas à charger, car il ne figure pas dans la liste des modes sans échec, ZwLoadDriver retourne STATUS_SUCCESS.

Un minifiltre doit utiliser FltLoadFilter au lieu de ZwLoadDriver pour charger un minifiltre de prise en charge.

Si l’appel à la fonction ZwLoadDriver se produit en mode utilisateur, vous devez utiliser le nom « NtLoadDriver » au lieu de « ZwLoadDriver ».

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm)

Voir aussi

FltLoadFilter

RtlInitUnicodeString

UNICODE_STRING

Utilisation des versions Nt et Zw des routines natives des services système natifs

ZwUnloadDriver