ioGetLowerDeviceObject 函式 (ntifs.h)

IoGetLowerDeviceObject常式會傳回驅動程式堆疊上下一層裝置物件的指標。

語法

PDEVICE_OBJECT IoGetLowerDeviceObject(
  [in] PDEVICE_OBJECT DeviceObject
);

參數

[in] DeviceObject

堆疊中要傳回下一個較低層級裝置物件的裝置物件的指標。

傳回值

IoGetLowerDeviceObject 會傳回驅動程式堆疊上下一層裝置物件的指標。

備註

指定檔案系統或設備磁碟機堆疊中裝置物件的指標, IoGetLowerDeviceObject 會傳回堆疊上下一個較低層級裝置物件的指標。

IoGetLowerDeviceObject會在:

  • 不會載入下一個較低層級的驅動程式。
  • 下一個較低層級的驅動程式目前正在卸載、移除或刪除。
  • DeviceObject指向的裝置物件是驅動程式堆疊中最低的裝置物件。
檔案系統篩選驅動程式通常會使用 IoGetLowerDeviceObject 來判斷它是否已附加至在指定檔案系統裝置物件上方鏈結的篩選驅動程式堆疊。 首先,篩選會呼叫 IoGetAttachedDeviceReference ,以取得堆疊中最上層裝置物件的指標。 然後它會重複呼叫 IoGetLowerDeviceObject 來逐步執行驅動程式堆疊,檢查每個裝置物件,以查看物件是否屬於篩選驅動程式。

IoGetLowerDeviceObject 會遞增下一個較低層級裝置物件的參考計數。 因此,後續呼叫ObDereferenceObject必須比對IoGetLowerDeviceObject的每個成功呼叫。

必要條件

   
最低支援的用戶端 此常式適用于 Windows 2000 Service Pack 4 (SP4) 和 Windows XP 和更新版本的更新彙總套件。
目標平臺 環球
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

另請參閱

IoGetAttachedDevice

IoGetAttachedDeviceReference

ObDereferenceObject