ホーム › System.Ioctl › FILESYSTEM_STATISTICS

FILESYSTEM_STATISTICS

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 56 バイト / x86: 56 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

型

サイズ

x64

x86

説明

FileSystemType

FILESYSTEM_STATISTICS_TYPE

ファイルシステムの種類です。

このメンバーは次のいずれかの値になります。

値

意味

FILESYSTEM_STATISTICS_TYPE_EXFAT
3

ファイルシステムは exFAT ファイルシステムです。

この値が設定されている場合、この構造体の後に EXFAT_STATISTICS 構造体が続きます。

Windows Vista、Windows Server 2003 および Windows XP: この値は Windows Vista SP1 以降でのみサポートされます。

FILESYSTEM_STATISTICS_TYPE_FAT
2

ファイルシステムは FAT ファイルシステムです。

この値が設定されている場合、この構造体の後に FAT_STATISTICS 構造体が続きます。

FILESYSTEM_STATISTICS_TYPE_NTFS
1

ファイルシステムは NTFS ファイルシステムです。

この値が設定されている場合、この構造体の後に NTFS_STATISTICS 構造体が続きます。

Version

WORD

このメンバーには 1 が設定されます。

SizeOfCompleteStructure

DWORD

この構造体のサイズと、この構造体の後に続くファイルシステム固有の構造体のサイズを合計し、プロセッサ数を掛けた値です。

この値は 64 の倍数でなければなりません。たとえば、 FILESYSTEM_STATISTICS のサイズが 0x38、 NTFS_STATISTICS のサイズが 0xD8 で、プロセッサが 2 個ある場合、割り当てるバッファーは 0x280 でなければなりません。

sizeof(FILESYSTEM_STATISTICS) = 0x38

sizeof(NTFS_STATISTICS) = 0xD8

合計サイズ = 0x110

構造体全体のサイズ = 0x140 (64 の倍数に整列した長さ)

2 (プロセッサ数) を掛けた値 = 0x280

UserFileReads

DWORD

ユーザーファイルに対する読み取り操作の回数です。

UserFileReadBytes

DWORD

+12

ユーザーファイルから読み取られたバイト数です。

UserDiskReads

DWORD

+16

ユーザーファイルに対する読み取り操作の回数です。

この値にはサブ読み取り操作が含まれます。

UserFileWrites

DWORD

+20

ユーザーファイルに対する書き込み操作の回数です。

UserFileWriteBytes

DWORD

+24

ユーザーファイルに書き込まれたバイト数です。

UserDiskWrites

DWORD

+28

ユーザーファイルに対する書き込み操作の回数です。

この値にはサブ書き込み操作が含まれます。

MetaDataReads

DWORD

+32

メタデータファイルに対する読み取り操作の回数です。

MetaDataReadBytes

DWORD

+36

メタデータファイルから読み取られたバイト数です。

MetaDataDiskReads

DWORD

+40

メタデータファイルに対する読み取り操作の回数です。

この値にはサブ読み取り操作が含まれます。

MetaDataWrites

DWORD

+44

メタデータファイルに対する書き込み操作の回数です。

MetaDataWriteBytes

DWORD

+48

メタデータファイルに書き込まれたバイト数です。

MetaDataDiskWrites

DWORD

+52

メタデータファイルに対する書き込み操作の回数です。

この値にはサブ書き込み操作が含まれます。

公式ドキュメント

ファイルシステムの統計情報を格納します。

ヒント Windows 10 を対象とするアプリケーションでは、FILESYSTEM_STATISTICS_EX を使用して追加の統計情報を取得できます。

解説(Remarks)

ファイルにはユーザーファイルとメタデータファイルの 2 種類があります。ユーザーファイルはユーザーが使用できるファイルです。メタデータファイルは、ファイルシステムが内部の管理のために使用する情報を格納するシステムファイルです。

測定される読み取り操作および書き込み操作の回数は、ページング操作の回数です。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// FILESYSTEM_STATISTICS  (x64 56 / x86 56 バイト)
typedef struct FILESYSTEM_STATISTICS {
    FILESYSTEM_STATISTICS_TYPE 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;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILESYSTEM_STATISTICS
{
    public ushort FileSystemType;
    public ushort Version;
    public uint SizeOfCompleteStructure;
    public uint UserFileReads;
    public uint UserFileReadBytes;
    public uint UserDiskReads;
    public uint UserFileWrites;
    public uint UserFileWriteBytes;
    public uint UserDiskWrites;
    public uint MetaDataReads;
    public uint MetaDataReadBytes;
    public uint MetaDataDiskReads;
    public uint MetaDataWrites;
    public uint MetaDataWriteBytes;
    public uint MetaDataDiskWrites;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILESYSTEM_STATISTICS
    Public FileSystemType As UShort
    Public Version As UShort
    Public SizeOfCompleteStructure As UInteger
    Public UserFileReads As UInteger
    Public UserFileReadBytes As UInteger
    Public UserDiskReads As UInteger
    Public UserFileWrites As UInteger
    Public UserFileWriteBytes As UInteger
    Public UserDiskWrites As UInteger
    Public MetaDataReads As UInteger
    Public MetaDataReadBytes As UInteger
    Public MetaDataDiskReads As UInteger
    Public MetaDataWrites As UInteger
    Public MetaDataWriteBytes As UInteger
    Public MetaDataDiskWrites As UInteger
End Structure

import ctypes
from ctypes import wintypes

class FILESYSTEM_STATISTICS(ctypes.Structure):
    _fields_ = [
        ("FileSystemType", ctypes.c_ushort),
        ("Version", ctypes.c_ushort),
        ("SizeOfCompleteStructure", wintypes.DWORD),
        ("UserFileReads", wintypes.DWORD),
        ("UserFileReadBytes", wintypes.DWORD),
        ("UserDiskReads", wintypes.DWORD),
        ("UserFileWrites", wintypes.DWORD),
        ("UserFileWriteBytes", wintypes.DWORD),
        ("UserDiskWrites", wintypes.DWORD),
        ("MetaDataReads", wintypes.DWORD),
        ("MetaDataReadBytes", wintypes.DWORD),
        ("MetaDataDiskReads", wintypes.DWORD),
        ("MetaDataWrites", wintypes.DWORD),
        ("MetaDataWriteBytes", wintypes.DWORD),
        ("MetaDataDiskWrites", wintypes.DWORD),
    ]

#[repr(C)]
pub struct FILESYSTEM_STATISTICS {
    pub FileSystemType: u16,
    pub Version: u16,
    pub SizeOfCompleteStructure: u32,
    pub UserFileReads: u32,
    pub UserFileReadBytes: u32,
    pub UserDiskReads: u32,
    pub UserFileWrites: u32,
    pub UserFileWriteBytes: u32,
    pub UserDiskWrites: u32,
    pub MetaDataReads: u32,
    pub MetaDataReadBytes: u32,
    pub MetaDataDiskReads: u32,
    pub MetaDataWrites: u32,
    pub MetaDataWriteBytes: u32,
    pub MetaDataDiskWrites: u32,
}

import "golang.org/x/sys/windows"

type FILESYSTEM_STATISTICS struct {
	FileSystemType uint16
	Version uint16
	SizeOfCompleteStructure uint32
	UserFileReads uint32
	UserFileReadBytes uint32
	UserDiskReads uint32
	UserFileWrites uint32
	UserFileWriteBytes uint32
	UserDiskWrites uint32
	MetaDataReads uint32
	MetaDataReadBytes uint32
	MetaDataDiskReads uint32
	MetaDataWrites uint32
	MetaDataWriteBytes uint32
	MetaDataDiskWrites uint32
}

type
  FILESYSTEM_STATISTICS = record
    FileSystemType: Word;
    Version: Word;
    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: DWORD;
  end;

const FILESYSTEM_STATISTICS = extern struct {
    FileSystemType: u16,
    Version: u16,
    SizeOfCompleteStructure: u32,
    UserFileReads: u32,
    UserFileReadBytes: u32,
    UserDiskReads: u32,
    UserFileWrites: u32,
    UserFileWriteBytes: u32,
    UserDiskWrites: u32,
    MetaDataReads: u32,
    MetaDataReadBytes: u32,
    MetaDataDiskReads: u32,
    MetaDataWrites: u32,
    MetaDataWriteBytes: u32,
    MetaDataDiskWrites: u32,
};

type
  FILESYSTEM_STATISTICS {.bycopy.} = object
    FileSystemType: uint16
    Version: uint16
    SizeOfCompleteStructure: uint32
    UserFileReads: uint32
    UserFileReadBytes: uint32
    UserDiskReads: uint32
    UserFileWrites: uint32
    UserFileWriteBytes: uint32
    UserDiskWrites: uint32
    MetaDataReads: uint32
    MetaDataReadBytes: uint32
    MetaDataDiskReads: uint32
    MetaDataWrites: uint32
    MetaDataWriteBytes: uint32
    MetaDataDiskWrites: uint32

struct FILESYSTEM_STATISTICS
{
    ushort FileSystemType;
    ushort Version;
    uint SizeOfCompleteStructure;
    uint UserFileReads;
    uint UserFileReadBytes;
    uint UserDiskReads;
    uint UserFileWrites;
    uint UserFileWriteBytes;
    uint UserDiskWrites;
    uint MetaDataReads;
    uint MetaDataReadBytes;
    uint MetaDataDiskReads;
    uint MetaDataWrites;
    uint MetaDataWriteBytes;
    uint MetaDataDiskWrites;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FILESYSTEM_STATISTICS サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; FileSystemType : FILESYSTEM_STATISTICS_TYPE (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; Version : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; SizeOfCompleteStructure : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; UserFileReads : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; UserFileReadBytes : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; UserDiskReads : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; UserFileWrites : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; UserFileWriteBytes : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; UserDiskWrites : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; MetaDataReads : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; MetaDataReadBytes : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; MetaDataDiskReads : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; MetaDataWrites : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; MetaDataWriteBytes : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; MetaDataDiskWrites : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global FILESYSTEM_STATISTICS
    #field short FileSystemType
    #field short Version
    #field int SizeOfCompleteStructure
    #field int UserFileReads
    #field int UserFileReadBytes
    #field int UserDiskReads
    #field int UserFileWrites
    #field int UserFileWriteBytes
    #field int UserDiskWrites
    #field int MetaDataReads
    #field int MetaDataReadBytes
    #field int MetaDataDiskReads
    #field int MetaDataWrites
    #field int MetaDataWriteBytes
    #field int MetaDataDiskWrites
#endstruct

stdim st, FILESYSTEM_STATISTICS        ; NSTRUCT 変数を確保
st->FileSystemType = 100
mes "FileSystemType=" + st->FileSystemType

FILESYSTEM_STATISTICS

フィールド

公式ドキュメント

解説(Remarks)

各言語での定義

HSP用 定義

HSP用定義