共用方式為


IoGetDiskDeviceObject 函式 (ntifs.h)

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

語法

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

參數

[in] FileSystemDeviceObject

檔系統裝置物件的指標。

DiskDeviceObject

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

傳回值

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

傳回碼 Description
STATUS_INVALID_PARAMETER
傳遞至此函式的其中一個參數無效。
STATUS_VOLUME_DISMOUNTED
STATUS_SUCCESS

備註

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

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

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

規格需求

需求
最低支援的用戶端 Windows 2000 SP4 更新匯總;Windowsxp
目標平台 Universal
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另請參閱

IoEnumerateDeviceObjectList

IoGetAttachedDevice

IoGetAttachedDeviceReference

IoGetLowerDeviceObject

ObDereferenceObject