This topic has not yet been rated - Rate this topic

FILESYSTEM_STATISTICS structure

Contains statistical information from the file system.

Syntax


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

Members

FileSystemType

The type of file system.

This member can be one of the following values.

Value	Meaning
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.

Value

Meaning

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 0xd4, and if there are 2 processors, the buffer allocated must be 0x280.

sizeof(FILESYSTEM_STATISTICS) = 0x38

sizeof(NTFS_STATISTICS) = 0xd4

Total Size = 0x10c

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)

Community Additions