FILE_REGION_INPUT構造体 (ntifs.h)

FILE_REGION_INPUT は、FSCTL_QUERY_FILE_REGIONSのオプションの入力構造です。

構文

typedef struct _FILE_REGION_INPUT {
  LONGLONG FileOffset;
  LONGLONG Length;
  ULONG    DesiredUsage;
} FILE_REGION_INPUT, *PFILE_REGION_INPUT;

FileOffset

ファイル内のバイト範囲の先頭のファイルオフセットをバイト単位で格納する 64 ビット符号付き整数。

Length

範囲のサイズ (バイト単位) を含む 64 ビット符号付き整数。

DesiredUsage

この操作の使用パラメーターを示す 32 ビット符号なし整数。 DesiredUsage には、次のいずれかの値を指定できます。

価値	意味
FILE_REGION_USAGE_VALID_CACHED_DATA (0x00000001)	キャッシュ内の指定されたファイルおよびファイル範囲の有効なデータ長 (VDL) に関する情報を返すように要求します。
FILE_REGION_USAGE_VALID_NONCACHED_DATA (0x00000002)	ディスク上の指定されたファイルおよびファイル範囲の VDL に関する情報を返すように要求します。
その他のすべての値	FSCTL_QUERY_FILE_REGIONで FILE_REGION_INPUT オブジェクトが指定されている場合、その他の値はSTATUS_INVALID_PARAMETERを返します。

詳細については、FSCTL_QUERY_FILE_REGIONS を参照してください。

要件	価値
サポートされる最小クライアント	Windows 8
ヘッダー	ntifs.h