Win32 API 日本語リファレンス
ホームSystem.Ioctl › CSV_QUERY_FILE_REVISION

CSV_QUERY_FILE_REVISION

構造体
サイズx64: 32 バイト / x86: 32 バイト

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

フィールド

フィールドサイズx64x86説明
FileIdLONGLONG8+0+0NTFS ファイルの識別子です。
FileRevisionLONGLONG24+8+8

ファイルのリビジョン追跡用の要素です。

  • FileRevision[0] は、CSV MDS スタックが再構築され、CSVFLT が状態を失うたびに増加します。
  • FileRevision[1] は、CSV MDS スタックがそのファイル用にキャッシュしているリビジョン番号を破棄するたびに増加します。
  • FileRevision[2] は、ファイル サイズが変更された可能性、またはファイルに書き込みが行われた可能性を CSV MDS が検出するたびに増加します。また、いずれかのノードが、このファイルに関連付けられたストリームを開いた後、そのストリームに対して最初の直接入出力操作を実行したときにも、この要素は増加します。
いずれかの値が 0 の場合、関数の呼び出し元はファイルが変更されたものと想定する必要があります。

公式ドキュメント

ストリーム内のファイルが変更されたかどうかに関する情報を格納します。

解説(Remarks)

この構造体は、FSCTL_CSV_CONTROL 制御コードが CSV_CONTROL_OP 列挙型の値 CsvControlQueryFileRevision を指定して呼び出された場合、またはその列挙値を含む CSV_CONTROL_PARAM 構造体と共にこの制御コードが使用された場合に使用されます。

リビジョンの追跡はストリーム単位ではなくファイル単位で行われるため、ストリームが変更されるたびに出力も変化します。

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

各言語での定義

#include <windows.h>

// CSV_QUERY_FILE_REVISION  (x64 32 / x86 32 バイト)
typedef struct CSV_QUERY_FILE_REVISION {
    LONGLONG FileId;
    LONGLONG FileRevision[3];
} CSV_QUERY_FILE_REVISION;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CSV_QUERY_FILE_REVISION
{
    public long FileId;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 3)] public long[] FileRevision;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CSV_QUERY_FILE_REVISION
    Public FileId As Long
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=3)> Public FileRevision() As Long
End Structure
import ctypes
from ctypes import wintypes

class CSV_QUERY_FILE_REVISION(ctypes.Structure):
    _fields_ = [
        ("FileId", ctypes.c_longlong),
        ("FileRevision", ctypes.c_longlong * 3),
    ]
#[repr(C)]
pub struct CSV_QUERY_FILE_REVISION {
    pub FileId: i64,
    pub FileRevision: [i64; 3],
}
import "golang.org/x/sys/windows"

type CSV_QUERY_FILE_REVISION struct {
	FileId int64
	FileRevision [3]int64
}
type
  CSV_QUERY_FILE_REVISION = record
    FileId: Int64;
    FileRevision: array[0..2] of Int64;
  end;
const CSV_QUERY_FILE_REVISION = extern struct {
    FileId: i64,
    FileRevision: [3]i64,
};
type
  CSV_QUERY_FILE_REVISION {.bycopy.} = object
    FileId: int64
    FileRevision: array[3, int64]
struct CSV_QUERY_FILE_REVISION
{
    long FileId;
    long[3] FileRevision;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CSV_QUERY_FILE_REVISION サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; FileId : LONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; FileRevision : LONGLONG (+8, 24byte)  varptr(st)+8 を基点に操作(24byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CSV_QUERY_FILE_REVISION
    #field int64 FileId
    #field int64 FileRevision 3
#endstruct

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