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 指向的緩衝區大小，以位元組為單位。
輸入/輸出緩衝區
n/a
輸入/輸出緩衝區長度
n/a
狀態區塊
保留供系統使用。
言論
若要執行這項作業，請使用下列參數呼叫 FltFsControlFile 或 ZwFsControlFile。
| 參數 | 描述 |
|---|---|
| 實例 | [in]僅適用於 FltFsControlFile。 呼叫端的不透明實例指標。 這個參數是必要的，而且不能是 NULL。 |
| FileObject | [in]僅適用於 FltFsControlFile。 此要求目標之檔案或目錄的檔案物件指標。 這個參數是必要的，而且不能是 NULL。 |
| FileHandle | [in]僅適用於 ZwFsControlFile。 此要求目標之檔案或目錄的檔案句柄。 這個參數是必要的，而且不能是 NULL。 |
| IoStatusBlock | [out]僅適用於 ZwFsControlFile。 IO_STATUS_BLOCK 結構的指標，其中會傳回要求的最終狀態。 |
| FsControlCode | [in]設定為 FSCTL_QUERY_FILE_REGIONS。 |
| InputBuffer | [in/optional]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 |