IoGetRelatedDeviceObject 函式 (wdm.h)
指定檔案物件時,IoGetRelatedDeviceObject 例程會傳回對應裝置物件的指標。
語法
PDEVICE_OBJECT IoGetRelatedDeviceObject(
[in] PFILE_OBJECT FileObject
);
參數
[in] FileObject
檔案物件的指標。
傳回值
IoGetRelatedDeviceObject 會傳回裝置物件的指標。
言論
在代表基礎儲存裝置的檔案物件上呼叫時,IoGetRelatedDeviceObject 傳回儲存裝置堆疊中最高層級的裝置物件。 若要取得文件系統驅動程式堆疊中最高層級的裝置對象,驅動程式必須在代表文件系統驅動程式堆疊的檔案物件上呼叫 IoGetRelatedDeviceObject,而且文件系統目前必須掛接。 (否則,會周遊存儲設備堆疊,而不是文件系統堆疊。
為了確保文件系統掛接在儲存設備上,驅動程式必須在開啟檔案物件所代表的檔案或裝置時指定適當的存取掩碼,例如FILE_READ_DATA或FILE_WRITE_ATTRIBUTES。 指定FILE_READ_ATTRIBUTES不會使檔案系統掛接。
呼叫端必須在 IRQL <= DISPATCH_LEVEL執行。 通常,此例程的呼叫端會在 IRQL = PASSIVE_LEVEL執行。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL (請參閱一節) |