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 に関する情報を返すように要求します。
その他のすべての値	FILE_REGION_INPUT オブジェクトが FSCTL_QUERY_FILE_REGION で指定されている場合、その他の値はSTATUS_INVALID_PARAMETERを返します。

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

要件	値
サポートされている最小のクライアント	Windows 8
Header	ntifs.h