Partilhar via


estrutura RETRIEVAL_POINTERS_BUFFER (winioctl.h)

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_195e_66 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 até o primeiro VCN da extensão em que o VCN inicial solicitado é encontrado.

NextVcn

Lcn

Extents[1]

Matriz de estruturas extensões de. 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 de Extensões) ou o NextVcn do membro anterior da matriz (para todos os outros membros da matriz Extents do) é 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
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho winioctl.h (inclua Windows.h)

Consulte também

de Desfragmentação

FSCTL_GET_RETRIEVAL_POINTERS

FSCTL_MOVE_FILE