Fungsi IoGetDeviceAttachmentBaseRef (ntifs.h)

Artikel
02/26/2024

Rutinitas IoGetDeviceAttachmentBaseRef mengembalikan penunjuk ke objek perangkat tingkat terendah dalam sistem file atau tumpukan driver perangkat.

Sintaks

PDEVICE_OBJECT IoGetDeviceAttachmentBaseRef(
  [in] PDEVICE_OBJECT DeviceObject
);

Parameter

[in] DeviceObject

Penunjuk ke objek perangkat di tumpukan.

Nilai kembali

IoGetDeviceAttachmentBaseRef mengembalikan pointer ke objek perangkat di bagian bawah sistem file atau tumpukan driver perangkat. Jika objek perangkat yang diberikan tidak dilampirkan ke tumpukan driver, IoGetDeviceAttachmentBaseRef mengembalikan penunjuk objek perangkat di DeviceObject.

Keterangan

Driver filter sistem file biasanya memanggil IoGetDeviceAttachmentBaseRef untuk mendapatkan objek perangkat tingkat terendah dalam tumpukan driver sistem file. Sering kali ini dilakukan ketika driver filter menerima pemberitahuan bahwa sistem file telah mendaftarkan atau membatalkan pendaftaran dirinya sebagai sistem file aktif. Rutinitas panggilan balik pemberitahuan driver filter memanggil IoGetDeviceAttachmentBaseRef untuk mendapatkan penunjuk ke objek perangkat kontrol sistem file, lalu memanggil ObQueryNameString untuk mengambil nama objek ini untuk tujuan penelusuran kesalahan.

IoGetDeviceAttachmentBaseRef meningkatkan jumlah referensi pada objek perangkat di bagian bawah tumpukan. Dengan demikian setiap panggilan yang berhasil ke IoGetDeviceAttachmentBaseRef harus dicocokkan dengan panggilan berikutnya ke 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