estrutura FSCTL_OFFLOAD_READ_OUTPUT (ntifs.h)

A estrutura FSCTL_OFFLOAD_READ_OUTPUT contém a saída para a solicitação de código de controle FSCTL_OFFLOAD_READ .

Sintaxe

typedef struct _FSCTL_OFFLOAD_READ_OUTPUT {
  ULONG     Size;
  ULONG     Flags;
  ULONGLONG TransferLength;
  UCHAR     Token[512];
} FSCTL_OFFLOAD_READ_OUTPUT, *PFSCTL_OFFLOAD_READ_OUTPUT;

Membros

Size

O tamanho desta estrutura. Defina esse membro como sizeof(FSCTL_OFFLOAD_READ_OUTPUT).

Flags

Sinalizadores de resultado. Esse valor é uma combinação OR bit a bit desses valores:

Valor	Significado
OFFLOAD_READ_FLAG_FILE_TOO_SMALL 0x00000001	O arquivo do qual ler é muito pequeno para uma operação de descarregamento.
OFFLOAD_READ_FLAG_ALL_ZERO_BEYOND_CURRENT_RANGE 0x00000002	O intervalo que se estende além do intervalo selecionado contém todos os zeros.
OFFLOAD_READ_FLAG_CANNOT_OFFLOAD_BEYOND_CURRENT_RANGE 0x00000004	A operação de descarregamento não pode ser concluída além do intervalo selecionado. Um método de leitura não descarregado deve ser usado para concluir a operação.

TransferLength

O comprimento, em bytes, dos dados representados por Token.

Token[512]

Uma matriz de bytes que contém uma estrutura de token, STORAGE_OFFLOAD_TOKEN, representando dados de arquivo dentro de um intervalo especificado em FSCTL_OFFLOAD_READ_INPUT. O conteúdo do Token deve permanecer não modificado entre as operações de descarregamento.

Comentários

Se a operação de FSCTL_OFFLOAD_READ for bem-sucedida, o provedor de cópia do dispositivo de armazenamento retornará, em FSCTL_OFFLOAD_READ_OUTPUT, um valor de token exclusivo que identifica a parte dos dados do arquivo lidos.

O provedor de cópia retém os dados lidos durante o membro TokenTimeToLive da estrutura FSCTL_OFFLOAD_READ_INPUT .

O token representa uma região contígua do arquivo que começa com o deslocamento solicitado no membro FileOffset do FSCTL_OFFLOAD_READ_INPUT. O comprimento resultante copiado, TransferLength, pode ser menor do que o especificado originalmente no membro CopyLength do FSCTL_OFFLOAD_READ_INPUT. Um valor menor indica que o Token foi capaz de representar logicamente menos dados do que o solicitado.

Se menos dados do que o solicitado tiver sido transferido, a operação de leitura poderá ser concluída executando outro FSCTL_OFFLOAD_READ solicitação. A próxima solicitação usa o membro FileOffset atualizado na estrutura FSCTL_OFFLOAD_READ_INPUT com o valor em TransferLength e um comprimento de leitura ajustado do comprimento anterior menos o valor em TransferLength. Além disso, uma operação de leitura incompleta pode ser concluída por meio de um método de leitura não descarregado, usando a rotina ZwReadFile , por exemplo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.
Cabeçalho	ntifs.h (include Ntifs.h, Fltkernel.h)

Confira também

FSCTL_OFFLOAD_READ

FSCTL_OFFLOAD_READ_INPUT

STORAGE_OFFLOAD_TOKEN