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
상태 블록
시스템 사용을 위해 예약되어 있습니다.
발언
이 작업을 수행하려면
| 매개 변수 | 묘사 |
|---|---|
| 인스턴스 | [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가 가리키는 |
| LengthRe가 | [out] OutputBuffer버퍼에 반환된 정보의 크기(바이트)를 수신하는 호출자 할당 변수에 대한 포인터입니다. |
반환 값
FSCTL_QUERY_FILE_REGIONS 성공적으로 완료되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 오류 코드를 반환합니다. 성공적으로 완료되면 호출자는 먼저 OutputBuffer반환된 정보에 액세스하기 전에 IoStatus.InformationLengthRe가 보다 크거나 같은지 확인해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 헤더 | ntifs.h |
참고 항목
fltFsControlFile
ZwFsControlFile