IOCTL_VOLUME_PHYSICAL_TO_LOGICAL IOCTL (ntddvol.h)

Artikel
08/07/2023

Mengembalikan offset logis yang sesuai dengan nomor disk fisik dan offset fisik.

Manajer volume mendukung IOCTL ini seperti yang dijelaskan untuk semua jenis volume dasar dan dinamis.

Kode utama

Buffer input

Penelepon menyisipkan struktur VOLUME_PHYSICAL_OFFSET, yang berisi offset fisik dan nomor disk fisik, di awal buffer, di Irp-AssociatedIrp.SystemBuffer>.

Panjang buffer input

Parameters.DeviceIoControl.InputBufferLength di lokasi tumpukan I/O IRP menunjukkan ukuran, dalam byte, dari buffer input, yang harus lebih besar dari atau sama dengan nilai sizeof(VOLUME_PHYSICAL_OFFSET).

Buffer output

Manajer volume mengembalikan offset logis dalam struktur VOLUME_LOGICAL_OFFSET di awal buffer, di Irp-AssociatedIrp.SystemBuffer>.

Panjang buffer output

Parameters.DeviceIoControl.OutputBufferLength di lokasi tumpukan I/O IRP menunjukkan ukuran, dalam byte, dari buffer output, yang harus lebih besar dari atau sama dengan nilai sizeof(VOLUME_LOGICAL_OFFSET).

Blok status

Jika operasi berhasil, anggota Status diatur ke STATUS_SUCCESS.

Jika buffer input atau output terlalu kecil, manajer volume mengatur anggota Status ke STATUS_BUFFER_TOO_SMALL. Jika data dikembalikan dalam buffer output tetapi buffer terlalu kecil untuk menerima semuanya, manajer volume mengatur anggota Status ke STATUS_BUFFER_OVERFLOW. Anggota Informasi diatur ke ukuran buffer output yang disediakan oleh pemanggil.

Jika nomor disk fisik dan offset fisik yang diberikan bukan milik volume atau jika diambil dari data paritas RAID, panggilan ini akan gagal dengan STATUS_INVALID_PARAMETER.