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上執行。

規格需求

另請參閱

IoGetDeviceObjectPointer