IOCTL_VOLUME_PHYSICAL_TO_LOGICAL IOCTL (ntddvol.h)
Gibt den logischen Offset zurück, der einer physischen Datenträgernummer und einem physischen Offset entspricht.
Der Volume-Manager unterstützt diese IOCTL wie für alle Typen von einfachen und dynamischen Volumes beschrieben.
Hauptcode
Eingabepuffer
Der Aufrufer fügt die VOLUME_PHYSICAL_OFFSET-Struktur mit dem physischen Offset und der physischen Datenträgernummer am Anfang des Puffers unter Irp-AssociatedIrp.SystemBuffer> ein.
Eingabepufferlänge
Parameters.DeviceIoControl.InputBufferLength in der E/A-Stapelposition des IRP gibt die Größe des Eingabepuffers in Bytes an, die größer oder gleich dem Wert von sizeof(VOLUME_PHYSICAL_OFFSET) sein muss.Ausgabepuffer
Der Volume-Manager gibt den logischen Offset in der VOLUME_LOGICAL_OFFSET-Struktur am Anfang des Puffers unter Irp-AssociatedIrp.SystemBuffer> zurück.
Länge des Ausgabepuffers
Parameters.DeviceIoControl.OutputBufferLength in der E/A-Stapelposition des IRP gibt die Größe des Ausgabepuffers in Bytes an, die größer oder gleich dem Wert von sizeof(VOLUME_LOGICAL_OFFSET) sein muss.Statusblock
Wenn der Vorgang erfolgreich ist, wird das Statuselement auf STATUS_SUCCESS festgelegt.
Wenn der Eingabe- oder Ausgabepuffer zu klein ist, legt der Volume-Manager das Statuselement auf STATUS_BUFFER_TOO_SMALL fest. Wenn Daten im Ausgabepuffer zurückgegeben werden, der Puffer jedoch zu klein ist, um sie alle zu empfangen, legt der Volume-Manager den Statusmember auf STATUS_BUFFER_OVERFLOW fest. Das Element Information ist auf die Größe des vom Aufrufer bereitgestellten Ausgabepuffers festgelegt.
Wenn die angegebene physische Datenträgernummer und der physische Offset nicht zum Volume gehören oder aus RAID-Paritätsdaten stammen, schlägt dieser Aufruf mit STATUS_INVALID_PARAMETER fehl.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar ab Windows XP. |
Kopfzeile | ntddvol.h (include Ntddvol.h) |