struktur RETRIEVAL_POINTERS_BUFFER (winioctl.h)

Berisi output untuk kode kontrol FSCTL_GET_RETRIEVAL_POINTERS.

Sintaksis

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

Anggota

ExtentCount

Jumlah elemen dalam array Extents.

StartingVcn

VCN awal yang dikembalikan oleh panggilan fungsi. Ini belum tentu VCN yang diminta oleh panggilan fungsi, karena driver sistem file dapat membulatkan ke bawah ke VCN pertama sejauh mana VCN awal yang diminta ditemukan.

NextVcn

Lcn

Extents[1]

Array Extents struktur. Untuk jumlah anggota dalam array, lihat ExtentCount. Setiap anggota array memiliki anggota berikut.

NextVcn

VCN di mana tingkat berikutnya dimulai. Nilai ini dikurangi StartingVcn (untuk Extents pertama anggota array) atau NextVcn dari anggota array sebelumnya (untuk semua Extents array anggota) adalah panjang, dalam kluster, dari tingkat saat ini. Panjangnya adalah input ke operasi FSCTL_MOVE_FILE.

Lcn

LCN di mana tingkat saat ini dimulai pada volume. Nilai ini adalah input ke operasi FSCTL_MOVE_FILE. Pada sistem file NTFS, nilai (LONGLONG) –1 menunjukkan unit kompresi yang dialokasikan sebagian, atau wilayah yang tidak dialokasikan dari file jarang.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winioctl.h (termasuk Windows.h)

Lihat juga

Defragmentasi

FSCTL_GET_RETRIEVAL_POINTERS

FSCTL_MOVE_FILE