STORAGE_OFFLOAD_TOKEN 结构 (winioctl.h)

包含用于表示文件的一部分的标记，用于卸载由DeviceDsmAction_OffloadRead指定的读取和写入操作或IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES控制代码DeviceDsmAction_OffloadWrite操作。

语法

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

成员

TokenType[4]

定义 Token 类型的 32 位无符号整数。

STORAGE_OFFLOAD_TOKEN_TYPE_WELL_KNOWN (0xFFFFFFFF)

Token 成员使用已知格式。 Token 成员的前两个字节是描述区域的 16 位无符号整数。 可能的值为 STORAGE_OFFLOAD_PATTERN_ZERO 或 STORAGE_OFFLOAD_PATTERN_ZERO_WITH_PROTECTION_INFO。 STORAGE_OFFLOAD_PATTERN_ZERO (0x0001) 是一个已知标记，指示表示的区域的所有位都设置为零。 STORAGE_OFFLOAD_PATTERN_ZERO_WITH_PROTECTION_INFO 是一个众所周知的标记，指示表示区域中的数据的所有位都设置为零，并且相应的保护信息有效。

0x00000000–0xFFFFFFFE

令牌成员使用特定于供应商的格式。

Reserved[2]

保留。

TokenIdLength[2]

令牌中令牌数据的长度。

DUMMYUNIONNAME

DUMMYUNIONNAME.StorageOffloadZeroDataToken

DUMMYUNIONNAME.StorageOffloadZeroDataToken.Reserved2[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

保留。

DUMMYUNIONNAME.Token[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

如果 TokenType 成员 STORAGE_OFFLOAD_TOKEN_TYPE_WELL_KNOWN 则前两个字节是描述该区域的 16 位无符号整数。 否则，这是特定于供应商的格式。

要求

要求	值
最低受支持的客户端	Windows 8
最低受支持的服务器	Windows Server 2012
标头	winioctl.h (包括 Windows.h)