ホーム › System.Ioctl › USN_JOURNAL_DATA_V0

USN_JOURNAL_DATA_V0

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
UsnJournalID	ULONGLONG	8	+0	+0	現在のジャーナル識別子です。ジャーナルには作成時に新しい識別子が割り当てられ、その存続期間中に新しい識別子が付与されることもあります。NTFS ファイルシステムはこの識別子を整合性チェックに使用します。
FirstUsn	LONGLONG	8	+8	+8	ジャーナルから読み取ることができる最初のレコードの番号です。
NextUsn	LONGLONG	8	+16	+16	次にジャーナルへ書き込まれるレコードの番号です。
LowestValidUsn	LONGLONG	8	+24	+24	このジャーナルインスタンスでジャーナルに最初に書き込まれたレコードです。ボリューム上のファイルまたはディレクトリを列挙すると、この値より小さい USN が返されることがあります (言い換えると、FirstUsn メンバーの値が LowestValidUsn メンバーの値より小さくなることがあります)。その場合、最後の USN が書き込まれてから、ジャーナルに新しい識別子が付与されています。この場合、LowestValidUsn はジャーナルの不連続性を示している可能性があり、ボリューム上の一部またはすべてのファイルやディレクトリに対して、変更ジャーナルに記録されていない変更が発生している可能性があります。
MaxUsn	LONGLONG	8	+32	+32	変更ジャーナルがサポートする最大の USN です。NextUsn の値がこの値に近づいたら、管理者は変更ジャーナルを削除する必要があります。
MaximumSize	ULONGLONG	8	+40	+40	変更ジャーナルの目標とする最大サイズ (バイト単位) です。変更ジャーナルはこの値より大きくなることがありますが、その場合は次の NTFS ファイルシステムチェックポイントでこの値未満に切り詰められます。
AllocationDelta	ULONGLONG	8	+48	+48	メモリの割り当てまたは解放が行われるたびに、変更ジャーナルの末尾に追加され、先頭から削除されるディスクメモリのバイト数です。言い換えると、割り当てと解放はこのサイズを単位として行われます。このメンバーには、クラスターサイズの整数倍が妥当な値です。

公式ドキュメント

更新シーケンス番号 (USN) 変更ジャーナル、そのレコード、および容量を表します。この構造体は FSCTL_QUERY_USN_JOURNAL 制御コードの出力バッファーです。Windows 8 および Windows Server 2012 より前では、この構造体は USN_JOURNAL_DATA という名前でした。古い SDK やコンパイラーでコンパイルする場合はその名前を使用してください。

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

各言語での定義

#include <windows.h>

// USN_JOURNAL_DATA_V0  (x64 56 / x86 56 バイト)
typedef struct USN_JOURNAL_DATA_V0 {
    ULONGLONG UsnJournalID;
    LONGLONG FirstUsn;
    LONGLONG NextUsn;
    LONGLONG LowestValidUsn;
    LONGLONG MaxUsn;
    ULONGLONG MaximumSize;
    ULONGLONG AllocationDelta;
} USN_JOURNAL_DATA_V0;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct USN_JOURNAL_DATA_V0
{
    public ulong UsnJournalID;
    public long FirstUsn;
    public long NextUsn;
    public long LowestValidUsn;
    public long MaxUsn;
    public ulong MaximumSize;
    public ulong AllocationDelta;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure USN_JOURNAL_DATA_V0
    Public UsnJournalID As ULong
    Public FirstUsn As Long
    Public NextUsn As Long
    Public LowestValidUsn As Long
    Public MaxUsn As Long
    Public MaximumSize As ULong
    Public AllocationDelta As ULong
End Structure

import ctypes
from ctypes import wintypes

class USN_JOURNAL_DATA_V0(ctypes.Structure):
    _fields_ = [
        ("UsnJournalID", ctypes.c_ulonglong),
        ("FirstUsn", ctypes.c_longlong),
        ("NextUsn", ctypes.c_longlong),
        ("LowestValidUsn", ctypes.c_longlong),
        ("MaxUsn", ctypes.c_longlong),
        ("MaximumSize", ctypes.c_ulonglong),
        ("AllocationDelta", ctypes.c_ulonglong),
    ]

#[repr(C)]
pub struct USN_JOURNAL_DATA_V0 {
    pub UsnJournalID: u64,
    pub FirstUsn: i64,
    pub NextUsn: i64,
    pub LowestValidUsn: i64,
    pub MaxUsn: i64,
    pub MaximumSize: u64,
    pub AllocationDelta: u64,
}

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

type USN_JOURNAL_DATA_V0 struct {
	UsnJournalID uint64
	FirstUsn int64
	NextUsn int64
	LowestValidUsn int64
	MaxUsn int64
	MaximumSize uint64
	AllocationDelta uint64
}

type
  USN_JOURNAL_DATA_V0 = record
    UsnJournalID: UInt64;
    FirstUsn: Int64;
    NextUsn: Int64;
    LowestValidUsn: Int64;
    MaxUsn: Int64;
    MaximumSize: UInt64;
    AllocationDelta: UInt64;
  end;

const USN_JOURNAL_DATA_V0 = extern struct {
    UsnJournalID: u64,
    FirstUsn: i64,
    NextUsn: i64,
    LowestValidUsn: i64,
    MaxUsn: i64,
    MaximumSize: u64,
    AllocationDelta: u64,
};

type
  USN_JOURNAL_DATA_V0 {.bycopy.} = object
    UsnJournalID: uint64
    FirstUsn: int64
    NextUsn: int64
    LowestValidUsn: int64
    MaxUsn: int64
    MaximumSize: uint64
    AllocationDelta: uint64

struct USN_JOURNAL_DATA_V0
{
    ulong UsnJournalID;
    long FirstUsn;
    long NextUsn;
    long LowestValidUsn;
    long MaxUsn;
    ulong MaximumSize;
    ulong AllocationDelta;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; USN_JOURNAL_DATA_V0 サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; UsnJournalID : ULONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; FirstUsn : LONGLONG (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; NextUsn : LONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; LowestValidUsn : LONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; MaxUsn : LONGLONG (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; MaximumSize : ULONGLONG (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; AllocationDelta : ULONGLONG (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global USN_JOURNAL_DATA_V0
    #field int64 UsnJournalID
    #field int64 FirstUsn
    #field int64 NextUsn
    #field int64 LowestValidUsn
    #field int64 MaxUsn
    #field int64 MaximumSize
    #field int64 AllocationDelta
#endstruct

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

USN_JOURNAL_DATA_V0

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義