IoGetDiskDeviceObject 函式 (ntifs.h)

IoGetDiskDeviceObject 例程會擷取與指定文件系統磁碟區裝置對象相關聯的磁碟裝置物件的指標。

語法

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

[in] FileSystemDeviceObject

檔系統裝置物件的指標。

DiskDeviceObject

接收磁碟裝置物件之裝置物件位址之變數的指標。

IoGetDiskDeviceObject 會傳回下列其中一個狀態值：

IoGetDiskDeviceObject 會傳回與文件系統磁碟區相關聯的記憶體裝置物件的指標。存儲設備不需要是實際的磁碟

文件系統篩選驅動程式通常會呼叫文件系統磁碟區裝置物件的 IoGetDiskDeviceObject ，以判斷是否已掛接磁碟區。

IoGetDiskDeviceObject 會遞增 DeviceObject 所指向磁碟裝置物件上的參考計數。因此，每次成功呼叫 IoGetDiskDeviceObject 時，都必須與後續對 ObDereferenceObject的呼叫進行比對。