Fungsi IoGetAttachedDeviceReference (ntifs.h)

  • Artikel

Rutinitas IoGetAttachedDeviceReference mengembalikan penunjuk ke objek perangkat tingkat tertinggi dalam tumpukan driver dan menambah jumlah referensi pada objek tersebut.

Sintaks

PDEVICE_OBJECT IoGetAttachedDeviceReference(
  [in] PDEVICE_OBJECT DeviceObject
);

Parameter

[in] DeviceObject

Penunjuk ke objek perangkat tempat objek perangkat terpasang paling atas diambil.

Nilai kembali

IoGetAttachedDeviceReference mengembalikan pointer ke objek perangkat tingkat tertinggi dalam tumpukan objek perangkat yang terpasang setelah menambah jumlah referensi pada objek.

Keterangan

Jika objek perangkat di DeviceObject tidak memiliki objek perangkat yang terpasang padanya, DeviceObject dan pointer yang dikembalikan sama.

Penulis driver perangkat harus memastikan bahwa ketika mereka telah menyelesaikan semua operasi yang mengharuskannya untuk melakukan panggilan ini, mereka memanggil ObDereferenceObject dengan pointer objek perangkat yang dikembalikan oleh rutinitas ini. Kegagalan untuk melakukannya akan mencegah sistem membebaskan atau menghapus objek perangkat karena jumlah referensi yang luar biasa.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000
Target Platform Universal
Header ntifs.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI DanglingDeviceObjectReference(wdm), HwStorPortProhibitedDDIs(storport)

Lihat juga

ObDereferenceObject