FILE_SEGMENT_ELEMENT union (winnt.h)

Represents a segment of an I/O buffer for scatter/gather read/write actions.

Syntax

typedef union _FILE_SEGMENT_ELEMENT {
  PVOID64   Buffer;
  ULONGLONG Alignment;
} FILE_SEGMENT_ELEMENT, *PFILE_SEGMENT_ELEMENT;

Members

Buffer

A pointer to the data for the scatter/gather read/write action.

Assigning a pointer to the Buffer member will sign-extend the value if the code is compiled as 32-bits; this can break large-address aware applications running on systems configured with 4-Gigabyte Tuning or running under WOW64 on 64-bit Windows. Therefore, use the PtrToPtr64 macro when assigning pointers to Buffer.

Alignment

An integer representation of the Buffer. The system uses this member to validate that the buffer is properly aligned. Applications typically operate on the Buffer member.

Requirements

Requirement Value
Header winnt.h

See also

WriteFileGather function, ReadFileScatter function