Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
FILESYSTEM_STATISTICS

FILESYSTEM_STATISTICS structure

Contains statistical information from the file system.

Tip  Applications targeting Windows 10 can access additional statistics through FILESYSTEM_STATISTICS_EX.
 

Syntax


typedef struct _FILESYSTEM_STATISTICS {
  USHORT FileSystemType;
  USHORT Version;
  ULONG  SizeOfCompleteStructure;
  ULONG  UserFileReads;
  ULONG  UserFileReadBytes;
  ULONG  UserDiskReads;
  ULONG  UserFileWrites;
  ULONG  UserFileWriteBytes;
  ULONG  UserDiskWrites;
  ULONG  MetaDataReads;
  ULONG  MetaDataReadBytes;
  ULONG  MetaDataDiskReads;
  ULONG  MetaDataWrites;
  DWORD  MetaDataWriteBytes;
  ULONG  MetaDataDiskWrites;
} FILESYSTEM_STATISTICS, *PFILESYSTEM_STATISTICS;

Members

FileSystemType

The type of file system.

This member can be one of the following values.

ValueMeaning
FILESYSTEM_STATISTICS_TYPE_EXFAT
3

The file system is an exFAT file system.

If this value is set, this structure is followed by an EXFAT_STATISTICS structure.

Windows Vista, Windows Server 2003, and Windows XP:  This value is not supported until Windows Vista with SP1.

FILESYSTEM_STATISTICS_TYPE_FAT
2

The file system is a FAT file system.

If this value is set, this structure is followed by a FAT_STATISTICS structure.

FILESYSTEM_STATISTICS_TYPE_NTFS
1

The file system is the NTFS file system.

If this value is set, this structure is followed by an NTFS_STATISTICS structure.

 

Version

This member is set to 1 (one).

SizeOfCompleteStructure

The size of this structure plus the size of the file system-specific structure that follows this structure, multiplied by the number of processors.

This value must be a multiple of 64. For example, if the size of FILESYSTEM_STATISTICS is 0x38, the size of NTFS_STATISTICS is 0xD8, and if there are 2 processors, the buffer allocated must be 0x280.

sizeof(FILESYSTEM_STATISTICS) = 0x38

sizeof(NTFS_STATISTICS) = 0xD8

Total Size = 0x110

size of the complete structure = 0x140 (which is the aligned length, a multiple of 64)

multiplied by 2 (the number of processors) = 0x280

UserFileReads

The number of read operations on user files.

UserFileReadBytes

The number of bytes read from user files.

UserDiskReads

The number of read operations on user files.

This value includes sub-read operations.

UserFileWrites

The number of write operations on user files.

UserFileWriteBytes

The number of bytes written to user files.

UserDiskWrites

The number of write operations on user files.

This value includes sub-write operations.

MetaDataReads

The number of read operations on metadata files.

MetaDataReadBytes

The number of bytes read from metadata files.

MetaDataDiskReads

The number of read operations on metadata files.

This value includes sub-read operations.

MetaDataWrites

The number of write operations on metadata files.

MetaDataWriteBytes

The number of bytes written to metadata files.

MetaDataDiskWrites

The number of write operations on metadata files.

This value includes sub-write operations.

Remarks

There are two types of files: user and metadata. User files are available for the user. Metadata files are system files that contain information, which the file system uses for its internal organization.

The number of read and write operations measured is the number of paging operations.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinIoCtl.h (include Windows.h)

See also

FSCTL_FILESYSTEM_GET_STATISTICS
EXFAT_STATISTICS
FAT_STATISTICS
NTFS_STATISTICS

 

 

Community Additions

ADD
Show:
© 2015 Microsoft