Fungsi IoGetLowerDeviceObject (ntifs.h)

Rutinitas IoGetLowerDeviceObject mengembalikan penunjuk ke objek perangkat tingkat bawah berikutnya pada tumpukan driver.

Sintaks

PDEVICE_OBJECT IoGetLowerDeviceObject(
  [in] PDEVICE_OBJECT DeviceObject
);

Parameter

[in] DeviceObject

Penunjuk ke objek perangkat di tumpukan tempat objek perangkat tingkat bawah berikutnya akan dikembalikan.

Mengembalikan nilai

IoGetLowerDeviceObject mengembalikan pointer ke objek perangkat tingkat bawah berikutnya pada tumpukan driver.

Keterangan

Mengingat penunjuk ke objek perangkat dalam sistem file atau tumpukan driver perangkat, IoGetLowerDeviceObject mengembalikan pointer ke objek perangkat tingkat bawah berikutnya pada tumpukan.

IoGetLowerDeviceObject mengembalikan NULL jika:

  • Driver tingkat bawah berikutnya tidak dimuat.
  • Driver tingkat bawah berikutnya saat ini sedang dibongkar, dihapus, atau dihapus.
  • Objek perangkat yang diarahkan oleh DeviceObject adalah objek perangkat terendah dalam tumpukan driver.
Driver filter sistem file biasanya menggunakan IoGetLowerDeviceObject untuk menentukan apakah sudah dilampirkan ke tumpukan driver filter yang ditautkan di atas objek perangkat sistem file tertentu. Pertama, filter memanggil IoGetAttachedDeviceReference untuk mendapatkan penunjuk ke objek perangkat paling atas di tumpukan. Kemudian memanggil IoGetLowerDeviceObject berulang kali untuk berjalan di tumpukan driver, memeriksa setiap objek perangkat untuk melihat apakah objek tersebut milik driver filter.

IoGetLowerDeviceObject menaikkan jumlah referensi pada objek perangkat tingkat bawah berikutnya. Dengan demikian setiap panggilan yang berhasil ke IoGetLowerDeviceObject harus dicocokkan dengan panggilan berikutnya ObDereferenceObject.

Persyaratan

   
Klien minimum yang didukung Rutinitas ini tersedia pada Pembaruan Rollup untuk Windows 2000 Paket Layanan 4 (SP4) dan pada Windows XP dan yang lebih baru.
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Lihat juga

IoGetAttachedDevice

IoGetAttachedDeviceReference

ObDereferenceObject