estrutura RETRIEVAL_POINTERS_BUFFER (winioctl.h)

  • Artigo

Contém a saída do código de controle FSCTL_GET_RETRIEVAL_POINTERS.

Sintaxe

typedef struct RETRIEVAL_POINTERS_BUFFER {
  DWORD                    ExtentCount;
  LARGE_INTEGER            StartingVcn;
  struct {
    LARGE_INTEGER NextVcn;
    LARGE_INTEGER Lcn;
  };
  __unnamed_struct_1932_64 Extents[1];
} RETRIEVAL_POINTERS_BUFFER, *PRETRIEVAL_POINTERS_BUFFER;

Membros

ExtentCount

A contagem de elementos na matriz Extents .

StartingVcn

O VCN inicial retornado pela chamada de função. Isso não é necessariamente o VCN solicitado pela chamada de função, pois o driver do sistema de arquivos pode arredondar para baixo para o primeiro VCN da extensão em que o VCN inicial solicitado é encontrado.

NextVcn

Lcn

Extents[1]

Matriz de estruturas extents . Para obter o número de membros na matriz, consulte ExtentCount. Cada membro da matriz tem os membros a seguir.

NextVcn

O VCN no qual a próxima extensão começa. Esse valor menos StartingVcn (para o primeiro membro da matriz Extents ) ou o NextVcn do membro anterior da matriz (para todos os outros membros da matriz Extents ) é o comprimento, em clusters, da extensão atual. O comprimento é uma entrada para a operação de FSCTL_MOVE_FILE .

Lcn

O LCN no qual a extensão atual começa no volume. Esse valor é uma entrada para a operação de FSCTL_MOVE_FILE . No sistema de arquivos NTFS, o valor (LONGLONG) –1 indica uma unidade de compactação parcialmente alocada ou uma região não alocada de um arquivo esparso.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também

Vantagens da desfragmentação

FSCTL_GET_RETRIEVAL_POINTERS

FSCTL_MOVE_FILE