IOCTL_VOLUME_PHYSICAL_TO_LOGICAL IOCTL (ntddvol.h)

Articolo
02/29/2024

Restituisce l'offset logico corrispondente a un numero di disco fisico e un offset fisico.

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

Codice principale

Buffer di input

Il chiamante inserisce la struttura di VOLUME_PHYSICAL_OFFSET contenente l'offset fisico e il numero di disco fisico, all'inizio del buffer, all'indirizzo 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_PHYSICAL_OFFSET).

Buffer di output

La gestione volumi restituisce l'offset logico nella struttura VOLUME_LOGICAL_OFFSET 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, che deve essere maggiore o uguale al valore di sizeof(VOLUME_LOGICAL_OFFSET).

Blocco dello stato

Se l'operazione ha esito positivo, il membro Status è impostato su STATUS_SUCCESS.

Se il buffer di input o di output è troppo piccolo, la gestione volumi imposta il membro Stato su STATUS_BUFFER_TOO_SMALL. Se i dati vengono restituiti nel buffer di output, ma il buffer è troppo piccolo per ricevere tutto, la gestione volumi imposta il membro Stato su STATUS_BUFFER_OVERFLOW. Il membro Information è impostato sulla dimensione del buffer di output fornito dal chiamante.

Se il numero di disco fisico specificato e l'offset fisico non appartengono al volume o se vengono presi dai dati di parità RAID, questa chiamata avrà esito negativo con STATUS_INVALID_PARAMETER.