FSCTL_QUERY_ALLOCATED_RANGES IOCTL(ntifs.h)
주 코드
FSCTL_QUERY_ALLOCATED_RANGES
입력 버퍼
할당을 쿼리할 범위를 나타내는 FILE_ALLOCATED_RANGE_BUFFER 구조체에 대한 포인터입니다.
입력 버퍼 길이
InputBuffer를 가리키는 FILE_ALLOCATED_RANGE_BUFFER 구조체의 크기(바이트)입니다.
출력 버퍼
쿼리 결과가 반환되는 0개 이상의 FILE_ALLOCATED_RANGE_BUFFER 데이터 요소 배열에 대한 포인터입니다. 자세한 내용은 아래를 참조하세요.
출력 버퍼 길이
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_ALLOCATED_RANGES. |
| InputBuffer | [in] 할당을 쿼리할 범위를 나타내는 FILE_ALLOCATED_RANGE_BUFFER 구조체에 대한 포인터입니다. |
| InputBufferLength | [in] InputBuffer를 가리키는 버퍼의 크기(바이트)입니다. |
| OutputBuffer | [out] 쿼리 결과가 반환되는 0개 이상의 FILE_ALLOCATED_RANGE_BUFFER 데이터 요소 배열에 대한 포인터입니다. 자세한 내용은 아래를 참조하세요. |
| outputBufferLength |
[out] OutputBuffer가 가리키는 |
| LengthRe가 | [out] OutputBuffer버퍼에 반환된 정보의 크기(바이트)를 수신하는 호출자 할당 변수에 대한 포인터입니다. |
FSCTL_QUERY_ALLOCATED_RANGES OutputBuffer가 가리키는 버퍼에서 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 |
참고 항목
fltFsControlFile
ZwFsControlFile