Fungsi IoGetAttachedDevice (ntifs.h)
Rutinitas IoGetAttachedDevice mengembalikan penunjuk ke objek perangkat tingkat tertinggi yang terkait dengan perangkat yang ditentukan.
Sintaks
PDEVICE_OBJECT IoGetAttachedDevice(
[in] PDEVICE_OBJECT DeviceObject
);
Parameter
[in] DeviceObject
Penunjuk ke objek perangkat tempat perangkat terpasang paling atas akan dikembalikan.
Nilai kembali
IoGetAttachedDevice mengembalikan perangkat tingkat tertinggi yang terpasang pada perangkat yang ditentukan.
Keterangan
Jika objek perangkat yang ditentukan oleh DeviceObject tidak memiliki objek perangkat lain yang terpasang padanya, DeviceObject dan pointer yang dikembalikan sama.
IoGetAttachedDevice berbeda dari IoGetAttachedDeviceReference dalam hal-hal berikut:
IoGetAttachedDevice tidak menaikkan jumlah referensi pada objek perangkat. (Dengan demikian tidak diperlukan panggilan yang cocok ke ObDereferenceObject .)
Penelepon IoGetAttachedDevice harus memastikan bahwa tidak ada objek perangkat yang ditambahkan atau dihapus dari tumpukan saat IoGetAttachedDevice dijalankan. Penelepon yang tidak dapat melakukan ini harus menggunakan IoGetAttachedDeviceReference sebagai gantinya .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | ntifs.h (termasuk Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |