Fungsi IoGetRelatedDeviceObject (wdm.h)
Mengingat objek file, rutinitas IoGetRelatedDeviceObject mengembalikan pointer ke objek perangkat yang sesuai.
Sintaks
PDEVICE_OBJECT IoGetRelatedDeviceObject(
[in] PFILE_OBJECT FileObject
);
Parameter
[in] FileObject
Penunjuk ke objek file.
Nilai kembali
IoGetRelatedDeviceObject mengembalikan pointer ke objek perangkat.
Keterangan
Ketika dipanggil pada objek file yang mewakili perangkat penyimpanan yang mendasar, IoGetRelatedDeviceObject mengembalikan objek perangkat tingkat tertinggi di tumpukan perangkat penyimpanan. Untuk mendapatkan objek perangkat tingkat tertinggi dalam tumpukan driver sistem file, driver harus memanggil IoGetRelatedDeviceObject pada objek file yang mewakili tumpukan driver sistem file, dan sistem file saat ini harus dipasang. (Jika tidak, tumpukan perangkat penyimpanan dilalui alih-alih tumpukan sistem file.)
Untuk memastikan bahwa sistem file dipasang pada perangkat penyimpanan, driver harus telah menentukan masker akses yang sesuai, seperti FILE_READ_DATA atau FILE_WRITE_ATTRIBUTES, saat membuka file atau perangkat yang diwakili oleh objek file. Menentukan FILE_READ_ATTRIBUTES tidak menyebabkan sistem file dipasang.
Pemanggil harus berjalan di IRQL <= DISPATCH_LEVEL. Biasanya, penelepon rutin ini berjalan di IRQL = PASSIVE_LEVEL.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 2000. |
| Target Platform | Universal |
| Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (lihat bagian Keterangan) |