estrutura FSCTL_OFFLOAD_READ_OUTPUT (ntifs.h)

A estrutura FSCTL_OFFLOAD_READ_OUTPUT contém a saída da 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 dessa estrutura. Defina esse membro como tamanhos de(FSCTL_OFFLOAD_READ_OUTPUT).

Flags

Sinalizadores de resultado. Esse valor é uma combinação OR bit a bit destes 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 vai 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.

Observações

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 de arquivo lidos.

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

Token representa uma região contígua do arquivo começando 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 em membro CopyLength do FSCTL_OFFLOAD_READ_INPUT. Um valor menor indica que token foi capaz de representar logicamente menos dados do que o solicitado.

Se menos dados do que os solicitados forem transferidos, a operação de leitura poderá ser concluída executando outra solicitação de FSCTL_OFFLOAD_READ. A próxima solicitação usa 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 de ZwReadFile, por exemplo.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8.
cabeçalho	ntifs.h (inclua Ntifs.h, Fltkernel.h)

Consulte também

FSCTL_OFFLOAD_READ

FSCTL_OFFLOAD_READ_INPUT

STORAGE_OFFLOAD_TOKEN