FSCTL_OFFLOAD_READ_OUTPUT Struktur (ntifs.h)
Die FSCTL_OFFLOAD_READ_OUTPUT-Struktur enthält die Ausgabe für die FSCTL_OFFLOAD_READ-Steuerelementcodeanforderung.
Syntax
typedef struct _FSCTL_OFFLOAD_READ_OUTPUT {
ULONG Size;
ULONG Flags;
ULONGLONG TransferLength;
UCHAR Token[512];
} FSCTL_OFFLOAD_READ_OUTPUT, *PFSCTL_OFFLOAD_READ_OUTPUT;
Member
Size
Die Größe dieser Struktur. Legen Sie dieses Element auf sizeof(FSCTL_OFFLOAD_READ_OUTPUT) fest.
Flags
Ergebnisflags. Dieser Wert ist eine bitweise OR-Kombination der folgenden Werte:
TransferLength
Die Länge der durch Token dargestellten Daten in Bytes.
Token[512]
Ein Bytearray, das eine Tokenstruktur STORAGE_OFFLOAD_TOKEN enthält, die eine Dateidaten in einem in FSCTL_OFFLOAD_READ_INPUT angegebenen Bereich darstellt. Der Inhalt von Token muss zwischen Auslagerungsvorgängen unverändert bleiben.
Hinweise
Wenn der FSCTL_OFFLOAD_READ Vorgang erfolgreich ist, gibt der Kopieranbieter des Speichergeräts in FSCTL_OFFLOAD_READ_OUTPUT einen eindeutigen Tokenwert zurück, der den Teil der gelesenen Dateidaten identifiziert.
Der Kopieranbieter behält die gelesenen Daten für die Dauer im TokenTimeToLive-Member der FSCTL_OFFLOAD_READ_INPUT-Struktur bei.
Token stellt einen zusammenhängenden Bereich der Datei dar, der mit dem angeforderten Offset im FileOffset-Element von FSCTL_OFFLOAD_READ_INPUT beginnt. Die resultierende, kopierte Länge , TransferLength, kann kleiner als die ursprünglich im CopyLength-Membervon FSCTL_OFFLOAD_READ_INPUT angegeben sein. Ein kleinerer Wert gibt an, dass Token logisch weniger Daten darstellen konnte als angefordert.
Wenn weniger Daten als angefordert übertragen wurden, kann der Lesevorgang durch Ausführen einer weiteren FSCTL_OFFLOAD_READ-Anforderung abgeschlossen werden. Die nächste Anforderung verwendet aktualisierte FileOffset-Member in der FSCTL_OFFLOAD_READ_INPUT-Struktur mit dem Wert in TransferLength und einer angepassten Leselänge der vorherigen Länge abzüglich des Werts in TransferLength. Außerdem kann ein unvollständiger Lesevorgang über eine nicht entladene Lesemethode abgeschlossen werden, z. B. mithilfe der ZwReadFile-Routine .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Kopfzeile | ntifs.h (include Ntifs.h, Fltkernel.h) |