FILE_ALLOCATED_RANGE_BUFFER 구조체(ntifs.h)

FILE_ALLOCATED_RANGE_BUFFER 구조체는 FSCTL_QUERY_ALLOCATED_RANGES 제어 코드 요청 중에 입력 및 출력으로 사용됩니다.

구문

typedef struct _FILE_ALLOCATED_RANGE_BUFFER {
  LARGE_INTEGER FileOffset;
  LARGE_INTEGER Length;
} FILE_ALLOCATED_RANGE_BUFFER, *PFILE_ALLOCATED_RANGE_BUFFER;

멤버

FileOffset

FSCTL 입력에서 는 파일에서 바이트 범위 시작의 파일 오프셋(바이트)을 포함합니다. FileOffset 은 0보다 크거나 같아야 합니다.

FSCTL 출력에서 는 파일 시작부터 파일 오프셋(바이트)을 포함합니다. 스토리지가 할당되는 바이트 범위의 시작입니다. 파일이 스파스 파일인 경우 FileOffset 에는 스토리지가 할당되지 않은 바이트 범위가 포함될 수 있습니다. 이러한 범위는 FSCTL_QUERY_ALLOCATED_RANGES 반환된 할당된 범위 목록에서 제외됩니다. 스파스 파일을 사용하는 애플리케이션은 각 시퀀스의 0x00 반환 바이트에 대한 디스크 공간을 할당할지 여부를 선택할 수 있으므로 할당된 범위에는 0x00 반환된 바이트가 포함될 수 있습니다. 이 값은 출력에서 0보다 크거나 같아야 합니다.

Length

범위의 크기(바이트)를 포함합니다. FSCTL 입력에서 길이 는 0보다 크거나 같아야 합니다. FSCTL 출력에서 길이 는 0보다 커야 합니다.

요구 사항

추가 정보

FSCTL_QUERY_ALLOCATED_RANGES