FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)
FSCTL_QUERY_FILE_REGIONS 、この FSCTL が呼び出されたハンドルに関連付けられているファイルについて、指定した使用法パラメーターに基づいてファイル領域の一覧を照会します。 このメッセージには、省略可能なFILE_REGION_INPUTデータ要素 が 含まれています。 FILE_REGION_INPUT パラメーターが指定されていない場合は、ファイルのサイズ全体に関する情報が返されます。
メジャー コード
FSCTL_QUERY_FILE_REGIONS
[入力バッファー]
クエリを実行するファイル領域を示す FILE_REGION_INPUT 構造体へのポインター。
入力バッファーの長さ
InputBuffer が指すFILE_REGION_INPUT構造体のサイズ (バイト単位)。
出力バッファー
クエリの結果が返される FILE_REGION_OUTPUT 構造体へのポインター。
出力バッファーの長さ
OutputBuffer が指すバッファーのサイズ (バイト単位)。
入力/出力バッファー
該当なし
入力/出力バッファーの長さ
該当なし
ステータス ブロック
システムで使用するために予約されています。
注釈
この操作を実行するには、次のパラメーターを指定して FltFsControlFile または ZwFsControlFile を呼び出します。
| パラメーター | 説明 |
|---|---|
| インスタンス | [入力] FltFsControlFile の場合のみ。 呼び出し元の不透明なインスタンス ポインター。 このパラメーターは必須であり、NULL にすることはできません。 |
| FileObject | [入力] FltFsControlFile の場合のみ。 この要求のターゲットであるファイルまたはディレクトリのファイル オブジェクト ポインター。 このパラメーターは必須であり、NULL にすることはできません。 |
| FileHandle | [入力] ZwFsControlFile の場合のみ。 この要求のターゲットであるファイルまたはディレクトリのファイル ハンドル。 このパラメーターは必須であり、NULL にすることはできません。 |
| IoStatusBlock | [out] ZwFsControlFile の場合のみ。 要求の最終状態が返される IO_STATUS_BLOCK 構造体へのポインター。 |
| FsControlCode | [入力] FSCTL_QUERY_FILE_REGIONSに設定します。 |
| InputBuffer | [入力/省略可能]クエリを実行するファイル領域を示す FILE_REGION_INPUT 構造体へのポインター。 |
| InputBufferLength | [入力] InputBuffer が指すバッファーのサイズ (バイト単位)。 |
| OutputBuffer | [out]クエリの結果が返される FILE_REGION_OUTPUT 構造体へのポインター。 |
| OutputBufferLength | [out] OutputBuffer が指すバッファーのサイズ (バイト単位)。 |
| LengthReturned | [out] OutputBuffer でバッファーに返される情報のサイズ (バイト単位) を受け取る呼び出し元割り当て変数へのポインター。 |
戻り値
FSCTL_QUERY_FILE_REGIONSは 、正常に完了するとSTATUS_SUCCESSを返します。それ以外の場合は、エラー コードを返します。 正常に完了すると、呼び出し元は、OutputBuffer で返される情報にアクセスする前に、IoStatus.Information が LengthReturned 以上であることを最初に確認する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| Header | ntifs.h |