IOCTL_VOLUME_LOGICAL_TO_PHYSICAL IOCTL (ntddvol.h)

Articolo
08/07/2023

Restituisce offset fisici e numeri di disco fisico per un determinato offset logico del volume.

Ad esempio, un offset di volume logico all'interno di un volume con mirroring con due plex corrisponde a due offset fisici, uno in ognuno dei due dischi che partecipano al mirror. In risposta a questo IOCTL, la gestione volumi restituisce due offset fisici e due numeri di disco fisico per l'offset del volume logico.

La gestione volumi supporta questo IOCTL per tutti i tipi di volumi di base e dinamici.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Il chiamante inserisce la struttura VOLUME_LOGICAL_OFFSET contenente l'offset logico all'inizio del buffer in Irp-AssociatedIrp.SystemBuffer>.

Lunghezza del buffer di input

Parameters.DeviceIoControl.InputBufferLength nella posizione dello stack I/O dell'IRP indica le dimensioni, in byte, del buffer di input, che deve essere maggiore o uguale al valore di sizeof(VOLUME_LOGICAL_OFFSET).

Buffer di output

Le dimensioni del buffer di output devono essere sufficienti per contenere la struttura VOLUME_PHYSICAL_OFFSETS, che contiene una matrice a lunghezza variabile di strutture di tipo VOLUME_PHYSICAL_OFFSET.

La gestione volumi restituisce uno o più offset fisici e numeri di disco nella struttura VOLUME_PHYSICAL_OFFSETS all'inizio del buffer, in Irp-AssociatedIrp.SystemBuffer>.

Lunghezza del buffer di output

Parameters.DeviceIoControl.OutputBufferLength nella posizione dello stack I/O dell'IRP indica le dimensioni, in byte, del buffer di output.

Blocco dello stato

Se l'operazione ha esito positivo, il membro Status è impostato su STATUS_SUCCESS. In caso contrario, il membro Stato è impostato sul codice di errore appropriato. I codici di errore possibili includono quanto segue:

STATUS_BUFFER_TOO_SMALL

Il buffer di output è troppo piccolo. La gestione volumi imposta il membro Irp-IoStatus.Information> sulla dimensione del buffer di output che il chiamante deve avere fornito.

STATUS_INVALID_PARAMETER

Il buffer di input è troppo piccolo.