Export (0) Print
Expand All
Expand Minimize

FILE_STORAGE_INFO structure

Contains directory information for a file. This structure is returned from the GetFileInformationByHandleEx function when FileStorageInfo is passed in the FileInformationClass parameter.

Syntax


typedef struct _FILE_STORAGE_INFO {
  ULONG LogicalBytesPerSector;
  ULONG PhysicalBytesPerSectorForAtomicity;
  ULONG PhysicalBytesPerSectorForPerformance;
  ULONG FileSystemEffectivePhysicalBytesPerSectorForAtomicity;
  ULONG Flags;
  ULONG ByteOffsetForSectorAlignment;
  ULONG ByteOffsetForPartitionAlignment;
} FILE_STORAGE_INFO, *PFILE_STORAGE_INFO;

Members

LogicalBytesPerSector

Logical bytes per sector reported by physical storage. This is the smallest size for which uncached I/O is supported.

PhysicalBytesPerSectorForAtomicity

Bytes per sector for atomic writes. Writes smaller than this may require a read before the entire block can be written atomically.

PhysicalBytesPerSectorForPerformance

Bytes per sector for optimal performance for writes.

FileSystemEffectivePhysicalBytesPerSectorForAtomicity

This is the size of the block used for atomicity by the file system. This may be a trade-off between the optimal size of the physical media and one that is easier to adapt existing code and structures.

Flags

This member can contain combinations of flags specifying information about the alignment of the storage.

ValueMeaning
STORAGE_INFO_FLAGS_ALIGNED_DEVICE
0x00000001

When set, this flag indicates that the logical sectors of the storage device are aligned to physical sector boundaries.

STORAGE_INFO_FLAGS_PARTITION_ALIGNED_ON_DEVICE
0x00000002

When set, this flag indicates that the partition is aligned to physical sector boundaries on the storage device.

 

ByteOffsetForSectorAlignment

Logical sector offset within the first physical sector where the first logical sector is placed, in bytes. If this value is set to STORAGE_INFO_OFFSET_UNKNOWN (0xffffffff), there was insufficient information to compute this field.

ByteOffsetForPartitionAlignment

Offset used to align the partition to a physical sector boundary on the storage device, in bytes. If this value is set to STORAGE_INFO_OFFSET_UNKNOWN (0xffffffff), there was insufficient information to compute this field.

Remarks

If a volume is built on top of storage devices with different properties (for example a mirrored, spanned, striped, or RAID configuration) the sizes returned are those of the largest size of any of the underlying storage devices.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

WinBase.h (include Windows.h)

See also

File Management Structures
GetFileInformationByHandleEx
FILE_INFO_BY_HANDLE_CLASS

 

 

Community Additions

ADD
Show:
© 2014 Microsoft