共用方式為


IoGetDiskDeviceObject 函式 (ntifs.h)

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

語法

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

參數

[in] FileSystemDeviceObject

檔系統裝置物件的指標。

DiskDeviceObject

變數的指標,會接收磁碟裝置對象的裝置物件位址。

傳回值

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

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

言論

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

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

IoGetDiskDeviceObject 會遞增 DeviceObject 所指向之磁碟裝置對象的參考計數。 因此,每次成功呼叫 IoGetDiskDeviceObject 時,都必須比對 ObDereferenceObject

要求

要求 價值
最低支援的用戶端 Windows 2000 SP4 更新匯總;Windows XP
目標平臺 普遍
標頭 ntifs.h (include Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另請參閱

IoEnumerateDeviceObjectList

IoGetAttachedDevice

IoGetAttachedDeviceReference

IoGetLowerDeviceObject

ObDereferenceObject