Funzione IoGetDriverDirectory (wdm.h)

Articolo
02/27/2024

Restituisce un handle a una directory su disco da cui il driver può leggere e scrivere file. I file in tale directory si applicano a un oggetto driver specifico.

Sintassi

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

Parametri

[_In_] DriverObject

Puntatore all'oggetto driver (struttura DRIVER_OBJECT ) del driver chiamante.

[_In_] DirectoryType

Valore di tipo _DRIVER_DIRECTORY_TYPE che indica il tipo di directory richiesta.

[_In_] Flags

Deve essere 0.

[_Out_] DriverDirectoryHandle

Puntatore a una variabile che riceve un handle alla directory del driver richiesta. Il chiamante non deve passare NULL.

Valore restituito

Restituisce un valore NTSTATUS appropriato. I valori possibili sono:

Codice di errore	Descrizione
STATUS_SUCCESS	La chiamata ha aperto correttamente un handle alla directory del driver richiesta.
STATUS_INVALID_PARAMETER	Un valore di input per questa funzione non è valido. Ad esempio, DriverObject o DriverDirectoryHandle è NULL; I flag non sono 0.

Commenti

Se IoGetDriverDirectory viene chiamato prima dell'avvio dei dischi e dei volumi necessari, la funzione non apre un handle e restituisce un errore.

I driver usano in genere ZwOpenFile e ZwCreateFile per accedere/creare file. Uno dei parametri per tali funzioni è una struttura OBJECT_ATTRIBUTES , che contiene il nome dell'oggetto e una directory radice. Se la directory radice è NULL, il nome dell'oggetto deve essere un percorso completo. Tuttavia, se si fornisce un handle per la directory radice, il nome dell'oggetto deve essere relativo all'oggetto (nel caso dei file, la directory), rappresentato dall'handle.

Al termine della chiamata IoGetDriverDirectory , usare l'handle ricevuto come directory radice nel OBJECT_ATTRIBUTES che si sta passando a zwOpenFile e ZwCreateFile.

Il driver deve chiamare ZwClose per chiudere l'handle ricevuto quando l'accesso non è più necessario.

I chiamanti di IoGetDriverDirectory devono essere in esecuzione in IRQL = PASSIVE_LEVEL nel contesto di un thread di sistema.