STORAGE_OFFLOAD_TOKEN 结构 (ntddstor.h)

STORAGE_OFFLOAD_TOKEN 结构包含一个标记值,该值用作卷上的文件中数据集范围的表示形式。 此结构用于执行卸载读取和写入。

语法

typedef struct _STORAGE_OFFLOAD_TOKEN {
  UCHAR TokenType[4];
  UCHAR Reserved[2];
  UCHAR TokenIdLength[2];
  union {
    struct {
      UCHAR Reserved2[STORAGE_OFFLOAD_TOKEN_ID_LENGTH];
    } StorageOffloadZeroDataToken;
    UCHAR Token[STORAGE_OFFLOAD_TOKEN_ID_LENGTH];
  } DUMMYUNIONNAME;
} STORAGE_OFFLOAD_TOKEN, *PSTORAGE_OFFLOAD_TOKEN;

成员

TokenType[4]

此结构中包含的标记类型。 TokenType 设置为以下任一项:

含义
STORAGE_OFFLOAD_TOKEN_TYPE_ZERO_DATA
令牌中包含一种已知的 令牌格式。 标记表示被视为全部零的数据。
任何其他值
特定于供应商的令牌格式包含在 令牌中。

Reserved[2]

保留。

TokenIdLength[2]

令牌中令牌数据的长度。

DUMMYUNIONNAME

DUMMYUNIONNAME.StorageOffloadZeroDataToken

当它表示的数据被视为全部零时,令牌值。 当 TokenType 设置为 STORAGE_OFFLOAD_TOKEN_TYPE_ZERO_DATA 时,此成员有效。

DUMMYUNIONNAME.StorageOffloadZeroDataToken.Reserved2[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

保留。

DUMMYUNIONNAME.Token[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

供应商提供的令牌值,表示卸载读取或写入操作的数据集范围。

注解

STORAGE_OFFLOAD_TOKEN中包含的令牌信息由卸载读/写基础结构生成。 此结构的所有成员都应被视为只读,并且不得由任何请求卸载读取或卸载写入的调用方修改。

要求

要求
最低受支持的客户端 从Windows 8开始可用。
标头 ntddstor.h (包括 Ntddstor.h)

另请参阅

DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS

STORAGE_OFFLOAD_READ_OUTPUT