ioGetDriverDirectory 函数 (wdm.h)

项目
08/08/2023

返回磁盘上目录的句柄，驱动程序可以从该目录读取和写入文件。该目录中的文件适用于特定的驱动程序对象。

语法

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

参数

[_In_] DriverObject

指向调用驱动程序 (DRIVER_OBJECT结构) 的驱动程序对象的指针。

[_In_] DirectoryType

指示所请求目录类型的 _DRIVER_DIRECTORY_TYPE类型值。

[_In_] Flags

必须为 0。

[_Out_] DriverDirectoryHandle

指向变量的指针，该变量接收请求的驱动程序目录的 HANDLE。调用方不得传递 NULL。

返回值

返回相应的 NTSTATUS 值。可能的值包括：

错误代码	说明
STATUS_SUCCESS	调用成功打开了请求的驱动程序目录的句柄。
STATUS_INVALID_PARAMETER	此函数的输入值无效。例如， DriverObject 或 DriverDirectoryHandle 为 NULL; 标志不为 0。

注解

如果在启动所需的磁盘和卷之前调用 IoGetDriverDirectory ，则函数不会打开句柄并返回错误。

驱动程序通常使用 ZwOpenFile 和 ZwCreateFile 来访问/创建文件。这些函数的参数之一是 OBJECT_ATTRIBUTES 结构，其中包含对象名称和根目录。如果根目录为 NULL，则对象名称必须是完全限定的路径。但是，如果为根目录提供句柄，则对象名称必须相对于对象 (，对于句柄表示的文件、目录) 。

IoGetDriverDirectory 调用成功后，使用收到的 HANDLE 作为要传递给 ZwOpenFile 和 ZwCreateFile的OBJECT_ATTRIBUTES中的根目录。

当不再需要访问时，驱动程序必须调用 ZwClose 以关闭收到的句柄。

IoGetDriverDirectory 的调用方必须在系统线程上下文中的 IRQL = PASSIVE_LEVEL 运行。