IoGetDiskDeviceObject 函数 (ntifs.h)

IoGetDiskDeviceObject 例程检索指向与给定文件系统卷设备对象关联的磁盘设备对象的指针。

语法

NTSTATUS IoGetDiskDeviceObject(
  [in] PDEVICE_OBJECT FileSystemDeviceObject,
       PDEVICE_OBJECT *DiskDeviceObject
);

[in] FileSystemDeviceObject

指向文件系统设备对象的指针。

DiskDeviceObject

指向变量的指针，该变量接收磁盘设备对象的设备对象的地址。

IoGetDiskDeviceObject 返回以下状态值之一：

IoGetDiskDeviceObject 返回指向与文件系统卷关联的存储设备对象的指针。存储设备不需要是实际磁盘

文件系统筛选器驱动程序通常为文件系统卷设备对象调用 IoGetDiskDeviceObject ，以确定卷是否已装载。

IoGetDiskDeviceObject 递增 DeviceObject 指向的磁盘设备对象的引用计数。因此，每次成功调用 IoGetDiskDeviceObject 都必须通过对 ObDereferenceObject 的后续调用进行匹配。