FSCTL_OFFLOAD_READ_INPUT structure (ntifs.h)

The FSCTL_OFFLOAD_READ_INPUT structure contains the input for the FSCTL_OFFLOAD_READ control code request.

Syntax

typedef struct _FSCTL_OFFLOAD_READ_INPUT {
 ULONG Size;
 ULONG Flags;
 ULONG TokenTimeToLive;
 ULONG Reserved;
 ULONGLONG FileOffset;
 ULONGLONG CopyLength;
} FSCTL_OFFLOAD_READ_INPUT, *PFSCTL_OFFLOAD_READ_INPUT;

Members

Size

The size in bytes of this structure. Set this member to sizeof(FSCTL_OFFLOAD_READ_INPUT).

Flags

This member is not used. Set to 0.

TokenTimeToLive

The time, in milliseconds, for which the read operation remains valid. The default time-to-live is 0. The recommended value for time-to-live is also 0.

Reserved

Reserved.

FileOffset

The position in the file to start reading from. The offset value must be aligned to a logical sector boundary on the volume.

CopyLength

The length, in bytes, of data to read, starting at FileOffset. The length value must align to a logical sector boundary on the volume, except when the length matches end-of-file.

Remarks

The storage device's copy provider retains the data read for the duration in TokenTimeToLive. Multiple writes with the same token can be performed until the time in TokenTimeToLive expires.

Requirements

See also

FSCTL_OFFLOAD_READ

FSCTL_OFFLOAD_READ_OUTPUT