Partilhar via


estrutura STORAGE_OFFLOAD_READ_OUTPUT (ntddstor.h)

A estrutura STORAGE_OFFLOAD_READ_OUTPUT é a saída de uma solicitação de código de controle IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES quando o membro Action de uma estrutura de DEVICE_DSM_INPUT é definido como DeviceDsmAction_OffloadRead.

Um token retornado identifica exclusivamente os intervalos de conjuntos de dados solicitados em DEVICE_DSM_INPUT. Em conjunto com DEVICE_DSM_INPUT, a estrutura de DEVICE_DSM_OFFLOAD_READ_PARAMETERS especifica por quanto tempo os intervalos de conjuntos de dados identificados pelo token retornado permanecem disponíveis para gravação subsequente.

Sintaxe

typedef struct _STORAGE_OFFLOAD_READ_OUTPUT {
  ULONG                 OffloadReadFlags;
  ULONG                 Reserved;
  ULONGLONG             LengthProtected;
  ULONG                 TokenLength;
  STORAGE_OFFLOAD_TOKEN Token;
} STORAGE_OFFLOAD_READ_OUTPUT, *PSTORAGE_OFFLOAD_READ_OUTPUT;

Membros

OffloadReadFlags

Não usado. Defina como 0.

Reserved

Reservado.

LengthProtected

O comprimento total, em bytes, de dados lidos e mantidos pelo provedor de cópia para Token.

TokenLength

O comprimento, em bytes, de Token.

Token

Um identificador exclusivo retornado pelo provedor de cópia, marcando os intervalos de conjunto de dados que são lidos.

Comentários

A estrutura STORAGE_OFFLOAD_READ_OUTPUT é retornada no início do buffer do sistema.

O valor de Token é gerado pelo provedor de cópia do dispositivo de armazenamento. Os intervalos do conjunto de dados incluídos quando a estrutura DEVICE_DSM_INPUT foi enviada na solicitação de código de controle IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES são marcados por Token. Os intervalos de conjuntos de dados associados ao Token estão disponíveis para solicitações de gravação subsequentes, enquanto a duração no membro TimeToLive de DEVICE_DSM_OFFLOAD_READ_PARAMETERS é válida.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível em Windows 8 e versões posteriores do Windows.
Cabeçalho ntddstor.h (inclua Ntddstor.h)

Confira também

DEVICE_DSM_OFFLOAD_READ_PARAMETERS

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES