IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS IOCTL (ntddvol.h)
Mengembalikan lokasi fisik volume pada satu atau beberapa disk. Jangkauan awalnya disimpan dalam urutan pembuatannya, tetapi merombak, memisahkan, atau memecahkan cermin, atau tindakan yang diambil selama pemulihan bencana, dapat memengaruhi urutan jangkauan disk.
Kode utama
Buffer input
Tidak ada.
Panjang buffer input
Tidak ada.
Buffer output
Driver mengembalikan struktur VOLUME_DISK_EXTENTS dalam buffer di Irp-AssociatedIrp.SystemBuffer>, yang harus setidaknya sizeof(VOLUME_DISK_EXTENTS).
Panjang buffer output
Panjang struktur VOLUME_DISK_EXTENTS.
Blok status
Driver mengatur Irp-IoStatus.Information> dan bidang Status sebagai berikut:
- Jika buffer di Irp->AssociatedIrp.SystemBuffer adalah < sizeof(VOLUME_DISK_EXTENTS), driver mengatur Irp->IoStatus.Information ke nol dan mengembalikan STATUS_INVALID_PARAMETER.
- Jika buffer di Irp->AssociatedIrp.SystemBuffer setidaknya berukuranof (VOLUME_DISK_EXTENTS) tetapi terlalu kecil untuk semua data yang akan dikembalikan, driver mengatur Irp->IoStatus.Information ke sizeof(VOLUME_DISK_EXTENTS) dan mengatur Status ke STATUS_BUFFER_OVERFLOW.
- Jika buffer di Irp->AssociatedIrp.SystemBuffer cukup besar untuk semua data yang akan dikembalikan, driver mengatur Irp->IoStatus.Information ke sizeof(VOLUME_DISK_EXTENTS) + ((NumberOfDiskExtents - 1) * sizeof(DISK_EXTENT)) dan mengatur Status ke STATUS_SUCCESS.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows 2000 untuk volume pada disk tetap, tetapi tidak untuk volume pada media yang dapat dilepas. Tersedia untuk digunakan dengan media yang dapat dilepas di Microsoft Windows 2000 SP4 dan Windows XP SP1. |
| Header | ntddvol.h (termasuk Ntddvol.h) |