estructura FSCTL_OFFLOAD_READ_OUTPUT (ntifs.h)
La estructura FSCTL_OFFLOAD_READ_OUTPUT contiene la salida de la solicitud de código de control FSCTL_OFFLOAD_READ.
Sintaxis
typedef struct _FSCTL_OFFLOAD_READ_OUTPUT {
ULONG Size;
ULONG Flags;
ULONGLONG TransferLength;
UCHAR Token[512];
} FSCTL_OFFLOAD_READ_OUTPUT, *PFSCTL_OFFLOAD_READ_OUTPUT;
Miembros
Size
Tamaño de esta estructura. Establezca este miembro en tamaño de(FSCTL_OFFLOAD_READ_OUTPUT).
Flags
Marcas de resultado. Este valor es un OR bit a bit combinación de estos valores:
TransferLength
Longitud, en bytes, de datos representados por Token.
Token[512]
Matriz de bytes que contiene una estructura de token, STORAGE_OFFLOAD_TOKEN, que representa los datos de un archivo dentro de un intervalo especificado en FSCTL_OFFLOAD_READ_INPUT. El contenido de token debe permanecer sin modificar entre las operaciones de descarga.
Observaciones
Si la operación de FSCTL_OFFLOAD_READ se realiza correctamente, el proveedor de copia del dispositivo de almacenamiento devuelve, en FSCTL_OFFLOAD_READ_OUTPUT, un valor de token único que identifica la parte de los datos de archivo leídos.
El proveedor de copia conserva los datos leídos durante el miembro tokenTimeToLive de la estructura de FSCTL_OFFLOAD_READ_INPUT.
token representa una región contigua del archivo que comienza con el desplazamiento solicitado en el miembro FileOffset de FSCTL_OFFLOAD_READ_INPUT. La longitud resultante copiada, transferLength, puede ser menor que la especificada originalmente en miembro copyLength de FSCTL_OFFLOAD_READ_INPUT. Un valor más pequeño indica que token pudo representar lógicamente menos datos de los solicitados.
Si se transfirieron menos datos de los solicitados, la operación de lectura se puede completar realizando otra solicitud de FSCTL_OFFLOAD_READ. La siguiente solicitud usa miembro FileOffset actualizado en la estructura FSCTL_OFFLOAD_READ_INPUT con el valor de TransferLength y una longitud de lectura ajustada de la longitud anterior menos el valor de TransferLength. Además, se puede completar una operación de lectura incompleta a través de un método de lectura no descargado, mediante la rutina de ZwReadFile, por ejemplo.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8. |
| encabezado de | ntifs.h (incluya Ntifs.h, Fltkernel.h) |