Fungsi IoGetLowerDeviceObject (ntifs.h)

  • Artikel

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.

Menampilkan nilai

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

Keterangan

Mengingat penunjuk ke objek perangkat dalam sistem file atau tumpukan driver perangkat, IoGetLowerDeviceObject mengembalikan penunjuk 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 jika ada. Dengan demikian setiap panggilan ke IoGetLowerDeviceObject yang tidak mengembalikan NULL harus dicocokkan dengan panggilan berikutnya ObDereferenceObject.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Rollup Pembaruan Windows 2000 SP4; Windows XP
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Lihat juga

IoGetAttachedDevice

IoGetAttachedDeviceReference

ObDereferenceObject