FSCTL_QUERY_ALLOCATED_RANGES IOCTL(ntifs.h)

FSCTL_QUERY_ALLOCATED_RANGES 0이 아닌 데이터를 포함할 수 있는 바이트 범위를 찾는 파일 또는 대체 스트림 의 검색을 요청한 다음 해당 범위에 대한 정보를 반환합니다. 스파스 파일만 운영 체제에 알려진 0개 범위를 가질 수 있습니다. 다른 파일의 경우 출력 버퍼에는 시작점과 요청된 길이가 포함된 단일 범위만 포함됩니다.

주 코드

FSCTL_QUERY_ALLOCATED_RANGES

입력 버퍼

할당을 쿼리할 범위를 나타내는 FILE_ALLOCATED_RANGE_BUFFER 구조체에 대한 포인터입니다.

입력 버퍼 길이

InputBuffer가 가리키는 FILE_ALLOCATED_RANGE_BUFFER 구조체의 크기(바이트)입니다.

출력 버퍼

쿼리 결과가 반환되는 0개 이상의 FILE_ALLOCATED_RANGE_BUFFER 데이터 요소 배열에 대한 포인터입니다. 자세한 내용은 아래를 참조하세요.

출력 버퍼 길이

OutputBuffer가 가리키는 버퍼의 크기(바이트)입니다.

입력/출력 버퍼

해당 없음

입력/출력 버퍼 길이

해당 없음

상태 블록

시스템에서 사용하도록 예약되었습니다.

설명

이 작업을 수행하려면 다음 매개 변수 를 사용하여 FltFsControlFile 또는 ZwFsControlFile 을 호출합니다.

매개 변수	Description
인스턴스	[in] FltFsControlFile에만 해당합니다 . 호출자에 대한 불투명 instance 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileObject	[in] FltFsControlFile에만 해당합니다 . 이 요청의 대상인 파일 또는 디렉터리에 대한 파일 개체 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileHandle	[in] ZwFsControlFile에만 해당합니다 . 이 요청의 대상인 파일 또는 디렉터리의 파일 핸들입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
IoStatusBlock	[out] ZwFsControlFile에만 해당합니다 . 요청의 최종 상태 포함하는 IO_STATUS_BLOCK 구조체에 대한 포인터입니다.
FsControlCode	[in] 를 FSCTL_QUERY_ALLOCATED_RANGES.
InputBuffer	[in] 할당을 쿼리할 범위를 나타내는 FILE_ALLOCATED_RANGE_BUFFER 구조체에 대한 포인터입니다.
InputBufferLength	[in] InputBuffer 가 가리키는 버퍼의 크기(바이트)입니다.
OutputBuffer	[out] 쿼리 결과가 반환되는 0개 이상의 FILE_ALLOCATED_RANGE_BUFFER 데이터 요소 배열에 대한 포인터입니다. 자세한 내용은 아래를 참조하세요.
OutputBufferLength	[out] OutputBuffer 가 가리키는 버퍼의 크기(바이트)입니다.
LengthReturned	[out] OutputBuffer에서 버퍼에 반환된 정보의 크기(바이트)를 수신하는 호출자 할당 변수에 대한 포인터입니다.

FSCTL_QUERY_ALLOCATED_RANGESOutputBuffer가 가리키는 버퍼에서 0개 이상의 FILE_ALLOCATED_RANGE_BUFFER 데이터 요소 배열을 반환합니다. 반환되는 FILE_ALLOCATED_RANGE_BUFFER 요소의 수는 LengthRe에서sizeof(FILE_ALLOCATED_RANGE_BUFFER)반환된 값을 로 나누어 계산됩니다. 반환된 범위는 InputBuffer에 지정된 범위와 교차해야 합니다. 파일에 할당된 범위가 없으면 0개의 FILE_ALLOCATED_RANGE_BUFFER 데이터 요소가 반환됩니다.

반환 값

FSCTL_QUERY_ALLOCATED_RANGES 성공적으로 완료되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 오류 코드를 반환합니다. 일반적인 오류 코드는 다음과 같습니다.

오류 코드	의미
STATUS_INVALID_PARAMETER	매개 변수가 잘못되었습니다. 예를 들어 핸들은 파일이 아닙니다. InputBuffer 의 크기가 FILE_ALLOCATED_RANGE_BUFFER 구조체의 크기보다 작습니다. FileOffset 이 0보다 작습니다. 길이 가 0보다 작습니다. 또는 FileOffset 및 Length 가 0x7FFFFFFFFFFFFFFF 보다 큽니다.
STATUS_INVALID_USER_BUFFER	입력 버퍼 또는 출력 버퍼가 4 바이트 경계에 정렬되지 않습니다.
STATUS_BUFFER_TOO_SMALL	출력 버퍼가 너무 작아서 FILE_ALLOCATED_RANGE_BUFFER 구조를 포함할 수 없습니다 .
STATUS_BUFFER_OVERFLOW	출력 버퍼가 너무 작아서 필요한 수의 FILE_ALLOCATED_RANGE_BUFFER 구조를 포함할 수 없습니다 .

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000
머리글	ntifs.h

추가 정보

FILE_ALLOCATED_RANGE_BUFFER

FltFsControlFile

ZwFsControlFile