The IoGetLowerDeviceObject routine returns a pointer to the next-lower-level device object on the driver stack.
PDEVICE_OBJECT IoGetLowerDeviceObject( _In_ PDEVICE_OBJECT DeviceObject );
A pointer to the device object in the stack for which the next-lower-level device object is to be returned.
IoGetLowerDeviceObject returns a pointer to the next-lower-level device object on the driver stack.
Given a pointer to a device object in a file system or device driver stack, IoGetLowerDeviceObject returns a pointer to the next-lower-level device object on the stack.
IoGetLowerDeviceObject returns NULL if:
The next-lower-level driver is not loaded.
The next-lower-level driver is currently being unloaded, removed, or deleted.
The device object pointed to by DeviceObject is the lowest device object in the driver stack.
IoGetLowerDeviceObject increments the reference count on the next-lower-level device object. Thus every successful call to IoGetLowerDeviceObject must be matched by a subsequent call ObDereferenceObject.
|Windows version||This routine is available on Update Rollup for Windows 2000 Service Pack 4 (SP4) and on Windows XP and later.|
|Header||ntifs.h (include Ntifs.h)|