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 。
| 參數 | Description |
|---|---|
| 執行個體 | [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;否則會傳回錯誤碼。 成功完成時，呼叫端應該先確認 IoStatus.Information 大於或等於 LengthReturned ，再存取 OutputBuffer 中傳回的資訊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 標頭 | ntifs.h |