struttura RETRIEVAL_POINTERS_BUFFER (winioctl.h)

Articolo
03/06/2025

Contiene l'output per il codice di controllo FSCTL_GET_RETRIEVAL_POINTERS.

Sintassi

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;

Membri

ExtentCount

Numero di elementi nella matrice Extents.

StartingVcn

VCN iniziale restituito dalla chiamata di funzione. Questo non è necessariamente il VCN richiesto dalla chiamata di funzione, perché il driver del file system può arrotondare fino al primo VCN dell'extent in cui viene trovato il VCN iniziale richiesto.

NextVcn

Lcn

Extents[1]

Matrice di strutture extent di. Per il numero di membri nella matrice, vedere ExtentCount. Ogni membro della matrice ha i membri seguenti.

NextVcn

VCN in corrispondenza del quale inizia l'extent successivo. Questo valore meno StartingVcn (per il primo membro extent extent) o il NextVcn del membro precedente della matrice (per tutti gli altri membri extent matrice) è la lunghezza, in cluster, dell'extent corrente. La lunghezza è un input per l'operazione di FSCTL_MOVE_FILE.

Lcn

LCN in corrispondenza del quale inizia l'extent corrente sul volume. Questo valore è un input per l'operazione di FSCTL_MOVE_FILE. Nel file system NTFS il valore (LONGLONG) –1 indica un'unità di compressione parzialmente allocata o un'area non allocata di un file sparse.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	winioctl.h (include Windows.h)

Vedere anche

deframmentazione

FSCTL_GET_RETRIEVAL_POINTERS

FSCTL_MOVE_FILE

Condividi tramite