IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS IOCTL (ntddvol.h)
Gibt die physischen Speicherorte eines Volumes auf einem oder mehreren Datenträgern zurück. Beeinträchtigungen werden zunächst in der Reihenfolge gespeichert, in der sie erstellt werden, aber das Erneute Bewundern, Teilen oder Unterbrechen einer Spiegelung oder Aktionen, die während der Notfallwiederherstellung ausgeführt werden, können sich auf die Reihenfolge der Datenträgerausdehnungen auswirken.
Hauptcode
Eingabepuffer
Nichts.
Eingabepufferlänge
Nichts.
Ausgabepuffer
Der Treiber gibt eine VOLUME_DISK_EXTENTS Struktur im Puffer bei Irp->AssociatedIrp.SystemBufferzurück, die mindestens Größe des(VOLUME_DISK_EXTENTS) sein muss.
Länge des Ausgabepuffers
Die Länge einer VOLUME_DISK_EXTENTS Struktur.
Statusblock
Der Treiber legt Irp->IoStatus.Information und das feld Status wie folgt fest:
- Wenn der Puffer bei Irp->AssociatedIrp.SystemBuffer< Größe(VOLUME_DISK_EXTENTS) ist, legt der Treiber Irp->IoStatus.Information auf Null fest und gibt STATUS_INVALID_PARAMETER zurück.
- Wenn der Puffer bei Irp->AssociatedIrp.SystemBuffer mindestens Größe von(VOLUME_DISK_EXTENTS) aufweist, aber zu klein ist, damit alle zurückgegebenen Daten zurückgegeben werden, legt der Treiber Irp->IoStatus.Information auf Größe(VOLUME_DISK_EXTENTS) fest und legt Status auf STATUS_BUFFER_OVERFLOW fest.
- Wenn der Puffer bei Irp->AssociatedIrp.SystemBuffer groß genug ist, damit alle Daten zurückgegeben werden können, der Treiber legt Irp->IoStatus.Information auf Größe von(VOLUME_DISK_EXTENTS) + ((NumberOfDiskExtents - 1) * Sizeof(DISK_EXTENT)) fest und legt Status auf STATUS_SUCCESS fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 für Volumes auf Festplatten, aber nicht für Volumes auf Wechselmedien. Verfügbar für die Verwendung mit Wechselmedien in Microsoft Windows 2000 SP4 und Windows XP SP1. |
| Header- | ntddvol.h (include Ntddvol.h) |