estructura FSCTL_OFFLOAD_WRITE_INPUT (ntifs.h)

Artículo
03/05/2024

La estructura FSCTL_OFFLOAD_WRITE_INPUT contiene la entrada de la solicitud de código de control de FSCTL_OFFLOAD_WRITE .

Sintaxis

typedef struct _FSCTL_OFFLOAD_WRITE_INPUT {
  ULONG     Size;
  ULONG     Flags;
  ULONGLONG FileOffset;
  ULONGLONG CopyLength;
  ULONGLONG TransferOffset;
  UCHAR     Token[512];
} FSCTL_OFFLOAD_WRITE_INPUT, *PFSCTL_OFFLOAD_WRITE_INPUT;

Miembros

Size

Tamaño de esta estructura. Establezca este miembro en sizeof(FSCTL_OFFLOAD_WRITE_INPUT).

Flags

Este miembro no se usa. Establecer en 0.

FileOffset

Posición en el archivo en la que se va a empezar a escribir. El valor de desplazamiento debe alinearse con un límite de sector lógico en el volumen.

CopyLength

Longitud, en bytes, de datos que se van a escribir, empezando por FileOffset. El valor de longitud debe alinearse con un límite de sector lógico en el volumen, excepto cuando la longitud coincide con el final del archivo.

TransferOffset

Posición de los datos asociados a Token desde la que empezar a escribir.

Token[512]

Matriz de bytes que contiene una estructura de tokens de STORAGE_OFFLOAD_TOKEN que representa un intervalo de datos de archivo que se va a escribir lógicamente. El contenido del token debe permanecer sin modificar entre las operaciones de descarga.

Comentarios

CopyLength puede ser cero. El valor de FileOffset + CopyLength está limitado por MAXULONGLONG y MAXFILESIZE. FSCTL_OFFLOAD_WRITE devuelve con STATUS_INVALID_PARAMETER si no se cumplen estas condiciones.