ホーム › System.Ioctl › FILESYSTEM_STATISTICS_EX

FILESYSTEM_STATISTICS_EX

構造体

📘 Microsoft Learn (日本語) · English

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

サイズ=各フィールドのバイト数(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 with SP1 以降でのみサポートされます。

FILESYSTEM_STATISTICS_TYPE_FAT
2

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

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

FILESYSTEM_STATISTICS_TYPE_NTFS
1

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

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

Version

WORD

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

SizeOfCompleteStructure

DWORD

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

この値は 64 の倍数でなければなりません。たとえば、 FILESYSTEM_STATISTICS_EX のサイズが 0x68、 NTFS_STATISTICS_EX のサイズが 0x1D8 で、プロセッサが 2 つある場合、割り当てるバッファーは 0x480 でなければなりません。

sizeof(FILESYSTEM_STATISTICS_EX) = 0x68

sizeof(NTFS_STATISTICS_EX) = 0x1D8

合計サイズ = 0x240

構造体全体のサイズ = 0x240 (これは 64 の倍数に整列された長さです)

プロセッサ数の 2 を掛けた値 = 0x480

UserFileReads

ULONGLONG

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

UserFileReadBytes

ULONGLONG

+16

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

UserDiskReads

ULONGLONG

+24

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

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

UserFileWrites

ULONGLONG

+32

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

UserFileWriteBytes

ULONGLONG

+40

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

UserDiskWrites

ULONGLONG

+48

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

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

MetaDataReads

ULONGLONG

+56

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

MetaDataReadBytes

ULONGLONG

+64

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

MetaDataDiskReads

ULONGLONG

+72

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

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

MetaDataWrites

ULONGLONG

+80

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

MetaDataWriteBytes

ULONGLONG

+88

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

MetaDataDiskWrites

ULONGLONG

+96

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

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

公式ドキュメント

ファイルシステムの統計情報を格納します。この構造体は Windows 10 以降でサポートされます。

解説(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_EX  (x64 104 / x86 104 バイト)
typedef struct FILESYSTEM_STATISTICS_EX {
    FILESYSTEM_STATISTICS_TYPE FileSystemType;
    WORD Version;
    DWORD SizeOfCompleteStructure;
    ULONGLONG UserFileReads;
    ULONGLONG UserFileReadBytes;
    ULONGLONG UserDiskReads;
    ULONGLONG UserFileWrites;
    ULONGLONG UserFileWriteBytes;
    ULONGLONG UserDiskWrites;
    ULONGLONG MetaDataReads;
    ULONGLONG MetaDataReadBytes;
    ULONGLONG MetaDataDiskReads;
    ULONGLONG MetaDataWrites;
    ULONGLONG MetaDataWriteBytes;
    ULONGLONG MetaDataDiskWrites;
} FILESYSTEM_STATISTICS_EX;

using System;
using System.Runtime.InteropServices;

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

Imports System.Runtime.InteropServices

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

import ctypes
from ctypes import wintypes

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

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

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

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

type
  FILESYSTEM_STATISTICS_EX = record
    FileSystemType: Word;
    Version: Word;
    SizeOfCompleteStructure: DWORD;
    UserFileReads: UInt64;
    UserFileReadBytes: UInt64;
    UserDiskReads: UInt64;
    UserFileWrites: UInt64;
    UserFileWriteBytes: UInt64;
    UserDiskWrites: UInt64;
    MetaDataReads: UInt64;
    MetaDataReadBytes: UInt64;
    MetaDataDiskReads: UInt64;
    MetaDataWrites: UInt64;
    MetaDataWriteBytes: UInt64;
    MetaDataDiskWrites: UInt64;
  end;

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

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

struct FILESYSTEM_STATISTICS_EX
{
    ushort FileSystemType;
    ushort Version;
    uint SizeOfCompleteStructure;
    ulong UserFileReads;
    ulong UserFileReadBytes;
    ulong UserDiskReads;
    ulong UserFileWrites;
    ulong UserFileWriteBytes;
    ulong UserDiskWrites;
    ulong MetaDataReads;
    ulong MetaDataReadBytes;
    ulong MetaDataDiskReads;
    ulong MetaDataWrites;
    ulong MetaDataWriteBytes;
    ulong 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_EX サイズ: 104 バイト(x64)
dim st, 26    ; 4byte整数×26(構造体サイズ 104 / 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 : ULONGLONG (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; UserFileReadBytes : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; UserDiskReads : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; UserFileWrites : ULONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; UserFileWriteBytes : ULONGLONG (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; UserDiskWrites : ULONGLONG (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; MetaDataReads : ULONGLONG (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; MetaDataReadBytes : ULONGLONG (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; MetaDataDiskReads : ULONGLONG (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; MetaDataWrites : ULONGLONG (+80, 8byte)  qpoke st,80,値 / qpeek(st,80)  ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; MetaDataWriteBytes : ULONGLONG (+88, 8byte)  qpoke st,88,値 / qpeek(st,88)  ※IronHSPのみ。3.7/3.8は lpoke st,88,下位 : lpoke st,92,上位
; MetaDataDiskWrites : ULONGLONG (+96, 8byte)  qpoke st,96,値 / qpeek(st,96)  ※IronHSPのみ。3.7/3.8は lpoke st,96,下位 : lpoke st,100,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

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

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

FILESYSTEM_STATISTICS_EX

フィールド

公式ドキュメント

解説(Remarks)

各言語での定義

HSP用 定義

HSP用定義