Edit

FSCTL_OFFLOAD_WRITE_INPUT structure (ntifs.h)

  • Article

The FSCTL_OFFLOAD_WRITE_INPUT structure contains the input for the FSCTL_OFFLOAD_WRITE control code request.

Syntax

typedef struct _FSCTL_OFFLOAD_WRITE_INPUT {
  ULONG     Size;
  ULONG     Flags;
  ULONGLONG FileOffset;
  ULONGLONG CopyLength;
  ULONGLONG TransferOffset;
  UCHAR     Token[512];
} FSCTL_OFFLOAD_WRITE_INPUT, *PFSCTL_OFFLOAD_WRITE_INPUT;

Members

Size

The size of this structure. Set this member to sizeof(FSCTL_OFFLOAD_WRITE_INPUT).

Flags

This member is not used. Set to 0.

FileOffset

The position in the file to begin writing to. The offset value must be aligned to a logical sector boundary on the volume.

CopyLength

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

TransferOffset

The position in the data associated with Token to begin writing from.

Token[512]

A byte array that contains a STORAGE_OFFLOAD_TOKEN token structure that represents a file data range to be logically written. The contents of Token must remain unmodified between offload operations.

Remarks

CopyLength can be zero. The value of FileOffset + CopyLength is bounded by both MAXULONGLONG and MAXFILESIZE. FSCTL_OFFLOAD_WRITE returns with STATUS_INVALID_PARAMETER if these conditions are not met.

Requirements

Requirement Value
Minimum supported client Windows 8
Header ntifs.h (include Ntifs.h, Fltkernel.h)

See also

FSCTL_OFFLOAD_READ

FSCTL_OFFLOAD_WRITE

FSCTL_OFFLOAD_WRITE_OUTPUT

STORAGE_OFFLOAD_TOKEN