IoGetDiskDeviceObject 函式 (ntifs.h)
IoGetDiskDeviceObject 例程會擷取與指定檔系統磁碟區裝置對象相關聯的磁碟裝置物件的指標。
語法
NTSTATUS IoGetDiskDeviceObject(
[in] PDEVICE_OBJECT FileSystemDeviceObject,
PDEVICE_OBJECT *DiskDeviceObject
);
參數
[in] FileSystemDeviceObject
檔系統裝置物件的指標。
DiskDeviceObject
變數的指標,會接收磁碟裝置對象的裝置物件位址。
傳回值
IoGetDiskDeviceObject 會傳回下列其中一個狀態值:
傳回碼 | 描述 |
---|---|
|
傳遞至此函式的其中一個參數無效。 |
|
|
|
言論
IoGetDiskDeviceObject 會傳回與文件系統磁碟區相關聯之存儲設備物件的指標。 存儲設備不需要實際磁碟
文件系統篩選驅動程式通常會呼叫 IoGetDiskDeviceObject 文件系統磁碟區裝置物件,以判斷磁碟區是否已掛接。
IoGetDiskDeviceObject 會遞增 DeviceObject 所指向之磁碟裝置對象的參考計數。 因此,每次成功呼叫 IoGetDiskDeviceObject 時,都必須比對 ObDereferenceObject。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 SP4 更新匯總;Windows XP |
目標平臺 | 普遍 |
標頭 | ntifs.h (include Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |