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