Fonction IoGetDriverDirectory (wdm.h)

Article
02/07/2025

Retourne un handle vers un répertoire sur le disque à partir duquel le pilote peut lire et écrire des fichiers. Les fichiers de ce répertoire s’appliquent à un objet de pilote spécifique.

Syntaxe

NTSTATUS IoGetDriverDirectory(
  [_In_]  PDRIVER_OBJECT        DriverObject,
  [_In_]  DRIVER_DIRECTORY_TYPE DirectoryType,
  [_In_]  ULONG                 Flags,
  [_Out_] PHANDLE               DriverDirectoryHandle
);

Paramètres

[_In_] DriverObject

Pointeur vers l’objet pilote (DRIVER_OBJECT structure) du pilote appelant.

[_In_] DirectoryType

Valeur _DRIVER_DIRECTORY_TYPE-type qui indique le type de répertoire demandé.

[_In_] Flags

Doit être 0.

[_Out_] DriverDirectoryHandle

Pointeur vers une variable qui reçoit un HANDLE vers le répertoire du pilote demandé. L’appelant ne doit pas passer NULL.

Valeur de retour

Retourne une valeur NTSTATUS appropriée . Les valeurs possibles sont les suivantes :

Code d’erreur	Description
STATUS_SUCCESS	L’appel a correctement ouvert un handle dans le répertoire du pilote demandé.
STATUS_INVALID_PARAMETER	Une valeur d’entrée pour cette fonction n’est pas valide. Par exemple, DriverObject ou DriverDirectoryHandle a la valeur NULL ; indicateurs n’est pas 0.

Remarques

Si IoGetDriverDirectory est appelé avant le démarrage des disques et volumes requis, la fonction n’ouvre pas de handle et retourne une erreur.

Les pilotes utilisent généralement ZwOpenFile et ZwCreateFile pour accéder/créer des fichiers. L’un des paramètres de ces fonctions est une structure OBJECT_ATTRIBUTES, qui contient le nom de l’objet et un répertoire racine. Si le répertoire racine est NULL, le nom de l’objet doit être un chemin complet. Toutefois, si vous fournissez un handle pour le répertoire racine, le nom de l’objet doit être relatif à l’objet (dans le cas de fichiers, le répertoire), que le handle représente.

Une fois l’appel IoGetDriverDirectory réussi, utilisez le HANDLE reçu comme répertoire racine dans le OBJECT_ATTRIBUTES que vous passez à un ZwOpenFile et ZwCreateFile.

Le pilote doit appeler ZwClose pour fermer le handle reçu lorsque l’accès n’est plus nécessaire.

Les appelants de IoGetDriverDirectory doivent s’exécuter à IRQL = PASSIVE_LEVEL dans le contexte d’un thread système.