RETRIEVAL_POINTERS_BUFFER-Struktur (winioctl.h)

  • Artikel

Enthält die Ausgabe für den Steuerungscode FSCTL_GET_RETRIEVAL_POINTERS.

Syntax

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;

Member

ExtentCount

Die Anzahl der Elemente im Array "Extents ".

StartingVcn

Der vom Funktionsaufruf zurückgegebene Start-VCN. Dies ist nicht unbedingt der vom Funktionsaufruf angeforderte VCN, da der Dateisystemtreiber möglicherweise auf den ersten VCN des Umfangs abrundet, in dem der angeforderte Start-VCN gefunden wird.

NextVcn

Lcn

Extents[1]

Array von Extents-Strukturen . Die Anzahl der Member im Array finden Sie unter ExtentCount. Jedes Element des Arrays verfügt über die folgenden Member.

NextVcn

Der VCN, an dem die nächste Erweiterung beginnt. Dieser Wert abzüglich StartingVcn (für den ersten Extents-Arraymember) oder der NextVcn des vorherigen Elements des Arrays (für alle anderen Extents-Arraymember) ist die Länge des aktuellen Bereichs in Clustern. Die Länge ist eine Eingabe für den FSCTL_MOVE_FILE Vorgang.

Lcn

Der LCN, bei dem die aktuelle Ausdehnung auf dem Volume beginnt. Dieser Wert ist eine Eingabe für den FSCTL_MOVE_FILE Vorgang. Im NTFS-Dateisystem gibt der Wert (LONGLONG) –1 entweder eine Teilweise zugeordnete Komprimierungseinheit oder einen nicht zugeordneten Bereich einer Sparsedatei an.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winioctl.h (windows.h einschließen)

Weitere Informationen

Defragmentierung

FSCTL_GET_RETRIEVAL_POINTERS

FSCTL_MOVE_FILE