Fungsi IoGetDiskDeviceObject (ntifs.h)
Rutinitas IoGetDiskDeviceObject mengambil pointer ke objek perangkat disk yang terkait dengan objek perangkat volume sistem file tertentu.
Sintaks
NTSTATUS IoGetDiskDeviceObject(
[in] PDEVICE_OBJECT FileSystemDeviceObject,
PDEVICE_OBJECT *DiskDeviceObject
);
Parameter
[in] FileSystemDeviceObject
Penunjuk ke objek perangkat sistem file.
DiskDeviceObject
Penunjuk ke variabel yang menerima alamat objek perangkat untuk objek perangkat disk.
Nilai kembali
IoGetDiskDeviceObject mengembalikan salah satu nilai status berikut:
| Menampilkan kode | Deskripsi |
|---|---|
|
Salah satu parameter yang diteruskan ke fungsi ini tidak valid. |
|
|
|
Keterangan
IoGetDiskDeviceObject mengembalikan pointer ke objek perangkat penyimpanan yang terkait dengan volume sistem file. Perangkat penyimpanan tidak perlu menjadi disk aktual
Driver filter sistem file biasanya memanggil IoGetDiskDeviceObject untuk objek perangkat volume sistem file untuk menentukan apakah volume dipasang.
IoGetDiskDeviceObject menambah jumlah referensi pada objek perangkat disk yang ditunjukkan oleh DeviceObject. Dengan demikian setiap panggilan yang berhasil ke IoGetDiskDeviceObject 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 |