IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS IOCTL (ntddvol.h)
Restituisce i percorsi fisici di un volume su uno o più dischi. Gli extent vengono inizialmente archiviati nell'ordine in cui vengono creati, ma rimirroing, suddivisione o interruzione di un mirror o azioni eseguite durante il ripristino di emergenza possono influire sull'ordine degli extent del disco.
Codice principale
Buffer di input
Nessuno.
Lunghezza del buffer di input
Nessuno.
Buffer di output
Il driver restituisce una struttura VOLUME_DISK_EXTENTS nel buffer in Irp-AssociatedIrp.SystemBuffer>, che deve essere almeno sizeof(VOLUME_DISK_EXTENTS).
Lunghezza del buffer di output
Lunghezza di una struttura VOLUME_DISK_EXTENTS.
Blocco dello stato
Il driver imposta Irp-IoStatus.Information> e il campo Stato come indicato di seguito:
- Se il buffer in Irp->AssociatedIrp.SystemBuffer è < sizeof(VOLUME_DISK_EXTENTS), il driver imposta Irp->IoStatus.Information su zero e restituisce STATUS_INVALID_PARAMETER.
- Se il buffer in Irp->AssociatedIrp.SystemBuffer è almeno sizeof(VOLUME_DISK_EXTENTS) ma troppo piccolo per tutti i dati da restituire, il driver imposta Irp->IoStatus.Information su sizeof(VOLUME_DISK_EXTENTS) e imposta Stato su STATUS_BUFFER_OVERFLOW.
- Se il buffer in Irp->AssociatedIrp.SystemBuffer è abbastanza grande per tutti i dati da restituire, il driver imposta Irp->IoStatus.Information to sizeof(VOLUME_DISK_EXTENTS) + ((NumberOfDiskExtents - 1) * sizeof(DISK_EXTENT)) e imposta Status su STATUS_SUCCESS.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 per i volumi su dischi fissi, ma non per i volumi su supporti rimovibili. Disponibile per l'uso con supporti rimovibili in Microsoft Windows 2000 SP4 e Windows XP SP1. |
| Intestazione | ntddvol.h (include Ntddvol.h) |