STORAGE_OFFLOAD_TOKEN 結構 (winioctl.h)

包含令牌，用來表示IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES控件程式代碼之DeviceDsmAction_OffloadRead或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

Token 成員會使用廠商特定的格式。

Reserved[2]

保留的。

TokenIdLength[2]

Token 中令牌數據的長度。

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)