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;

Angehörige

Size

Die Größe dieser Struktur. Legen Sie dieses Element auf Größe von(FSCTL_OFFLOAD_READ_OUTPUT) fest.

Flags

Ergebniskennzeichnungen. Dieser Wert ist ein bitweiser ODER Kombination dieser Werte:

Wert	Bedeutung
OFFLOAD_READ_FLAG_FILE_TOO_SMALL 0x00000001	Die datei, aus der gelesen werden soll, ist zu klein für einen Offloadvorgang.
OFFLOAD_READ_FLAG_ALL_ZERO_BEYOND_CURRENT_RANGE 0x00000002	Der Bereich, der über den ausgewählten Bereich hinausgeht, enthält alle Nullen.
OFFLOAD_READ_FLAG_CANNOT_OFFLOAD_BEYOND_CURRENT_RANGE 0x00000004	Der Ausladevorgang kann nicht über den ausgewählten Bereich hinaus abgeschlossen werden. Zum Abschließen des Vorgangs sollte eine nicht ausgeladene Lesemethode verwendet werden.

TransferLength

Die Länge in Byte von Daten, die durch Tokendargestellt werden.

Token[512]

Ein Bytearray, das eine Tokenstruktur enthält, STORAGE_OFFLOAD_TOKEN, die eine Dateidaten innerhalb eines bereichs darstellt, der in FSCTL_OFFLOAD_READ_INPUTangegeben ist. Der Inhalt Token- muss zwischen Offloadvorgängen unverändert bleiben.

Bemerkungen

Wenn der FSCTL_OFFLOAD_READ-Vorgang erfolgreich ist, gibt der Kopieranbieter des Speichergeräts in FSCTL_OFFLOAD_READ_OUTPUTeinen eindeutigen Tokenwert zurück, der den Teil der Gelesenen von Dateidaten identifiziert.

Der Kopieranbieter behält die Daten, die für die Dauer im TokenTimeToLive Mitglied der FSCTL_OFFLOAD_READ_INPUT-Struktur gelesen werden.

Token- stellt einen zusammenhängenden Bereich der Datei dar, der mit dem angeforderten Offset im FileOffset Member von FSCTL_OFFLOAD_READ_INPUTbeginnt. Die resultierende Länge kopiert, TransferLength, kann kleiner sein als das, was ursprünglich in CopyLength Member von FSCTL_OFFLOAD_READ_INPUTangegeben wurde. Ein kleinerer Wert gibt an, dass Token- logisch weniger Daten darstellen konnten als angefordert.

Wenn weniger Daten als angefordert übertragen wurden, kann der Lesevorgang durch Ausführen einer anderen 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 ausgeladene Lesemethode abgeschlossen werden, z. B. mithilfe der ZwReadFile Routine.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8.
Header-	ntifs.h (einschließlich Ntifs.h, Fltkernel.h)

Siehe auch

FSCTL_OFFLOAD_READ

FSCTL_OFFLOAD_READ_INPUT

STORAGE_OFFLOAD_TOKEN