STORAGE_OFFLOAD_READ_OUTPUT 结构 (ntddstor.h)

  • 项目

当DEVICE_DSM_INPUT结构的 Action 成员设置为 DeviceDsmAction_OffloadRead 时，STORAGE_OFFLOAD_READ_OUTPUT结构是IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES控制代码请求的输出。

返回的令牌唯一标识DEVICE_DSM_INPUT中请求的数据集范围。 结合 DEVICE_DSM_INPUT，DEVICE_DSM_OFFLOAD_READ_PARAMETERS 结构指定返回的令牌标识的数据集范围在后续写入中保持可用时间。

语法

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;

成员

OffloadReadFlags

未使用。 设置为 0。

Reserved

保留。

LengthProtected

由令牌的复制提供程序读取和保留的数据的总长度（以字节为单位）。

TokenLength

Token 的长度（以字节为单位）。

Token

复制提供程序返回的唯一标识符，用于标记读取的数据集范围。

注解

在系统缓冲区的开头返回STORAGE_OFFLOAD_READ_OUTPUT结构。

Token 的值由存储设备的复制提供程序生成。 在IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES控制代码请求中发送 DEVICE_DSM_INPUT 结构时包含 的 数据集范围由 Token 标记。 与 Token 关联的数据集范围可用于后续写入请求，而DEVICE_DSM_OFFLOAD_READ_PARAMETERS的 TimeToLive 成员中的持续时间有效。

要求

要求 值
最低受支持的客户端 在 Windows 8 及更高版本的 Windows 中可用。
标头 ntddstor.h (包括 Ntddstor.h)

另请参阅

DEVICE_DSM_OFFLOAD_READ_PARAMETERS

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES