estrutura FILE_ALLOCATED_RANGE_BUFFER (ntifs.h)

  • Artigo

FILE_ALLOCATED_RANGE_BUFFER estruturas são usadas como entrada e saída durante uma solicitação de código de controle FSCTL_QUERY_ALLOCATED_RANGES .

Sintaxe

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

Membros

FileOffset

Na entrada FSCTL, contém o deslocamento de arquivo em bytes do início de um intervalo de bytes em um arquivo. FileOffset deve ser maior ou igual a 0.

Na saída FSCTL, contém o deslocamento de arquivo em bytes desde o início do arquivo; o início de um intervalo de bytes aos quais o armazenamento é alocado. Se o arquivo for um arquivo esparso, FileOffset poderá conter intervalos de bytes para os quais o armazenamento não está alocado; esses intervalos serão excluídos da lista de intervalos alocados retornados por FSCTL_QUERY_ALLOCATED_RANGES. Como um aplicativo que usa um arquivo esparso pode escolher se deseja ou não alocar espaço em disco para cada sequência de bytes com valor 0x00, os intervalos alocados podem conter bytes com valor 0x00. Esse valor deve ser maior ou igual a 0 na saída.

Length

Contém o tamanho em bytes do intervalo. Na entrada FSCTL, Length deve ser maior ou igual a 0. Na saída FSCTL, Length deve ser maior que 0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000
Cabeçalho ntifs.h

Confira também

FSCTL_QUERY_ALLOCATED_RANGES