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_OUTPUT 構造体へのポインター。
出力バッファーの長さ
OutputBuffer が指
入力/出力バッファー
n/a
入力/出力バッファーの長さ
n/a
状態ブロック
システム用に予約されています。
備考
この操作を実行するには、FltFsControlFile
| パラメーター | 形容 |
|---|---|
| インスタンス | [in]fltFsControlFile のみ。 呼び出し元の不透明なインスタンス ポインター。 このパラメーターは必須であり、NULL にすることはできません。 |
| FileObject | [in]fltFsControlFile のみ。 この要求のターゲットであるファイルまたはディレクトリのファイル オブジェクト ポインター。 このパラメーターは必須であり、NULL にすることはできません。 |
| FileHandle | [in]ZwFsControlFile のみ。 この要求のターゲットであるファイルまたはディレクトリのファイル ハンドル。 このパラメーターは必須であり、NULL にすることはできません。 |
| IoStatusBlock の |
[out]ZwFsControlFile のみ。 要求の最終的な状態が返される IO_STATUS_BLOCK 構造体へのポインター。 |
| FsControlCode の |
[in]FSCTL_QUERY_FILE_REGIONSに設定します。 |
| InputBuffer の |
[入力/省略可能]クエリするファイル領域を示す FILE_REGION_INPUT 構造体へのポインター。 |
| InputBufferLength | [in]InputBuffer が指 |
| OutputBuffer の |
[out]クエリの結果が返される FILE_REGION_OUTPUT 構造体へのポインター。 |
| OutputBufferLength | [out]OutputBuffer が指 |
| LengthReturned | [out]OutputBufferでバッファーに返される情報のサイズ (バイト単位) を受け取る呼び出し元によって割り当てられた変数 |
戻り値
FSCTL_QUERY_FILE_REGIONS は、正常に完了するとSTATUS_SUCCESSを返します。それ以外の場合は、エラー コードが返されます。 正常に完了したら、呼び出し元は、
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 |
| ヘッダー | ntifs.h |
関連項目
FltFsControlFile の