estructura RETRIEVAL_POINTERS_BUFFER (winioctl.h)

Contiene la salida del código de control de FSCTL_GET_RETRIEVAL_POINTERS.

Sintaxis

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;

Miembros

ExtentCount

Recuento de elementos de la matriz Extensiones.

StartingVcn

VcN inicial devuelto por la llamada de función. Esto no es necesariamente el VCN solicitado por la llamada de función, ya que el controlador del sistema de archivos puede redondear hacia abajo hasta el primer VCN de la extensión en la que se encuentra el VCN inicial solicitado.

NextVcn

Lcn

Extents[1]

Matriz de estructuras de Extensiones. Para obtener el número de miembros de la matriz, vea ExtentCount. Cada miembro de la matriz tiene los siguientes miembros.

NextVcn

VcN en el que comienza la siguiente extensión. Este valor menos StartingVcn (para el primer miembro de matriz Extensiones) o el NextVcn del miembro anterior de la matriz (para todos los demás miembros de matriz Extensiones) es la longitud, en clústeres, de la extensión actual. La longitud es una entrada para la operación FSCTL_MOVE_FILE.

Lcn

LCN en el que comienza la extensión actual en el volumen. Este valor es una entrada para la operación de FSCTL_MOVE_FILE. En el sistema de archivos NTFS, el valor (LONGLONG) –1 indica una unidad de compresión que se asigna parcialmente o una región sin asignar de un archivo disperso.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	winioctl.h (incluya Windows.h)

Consulte también

de desfragmentación de

FSCTL_GET_RETRIEVAL_POINTERS

FSCTL_MOVE_FILE