структура 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
Хорошо известный формат маркера содержится в token. Маркер представляет данные, которые считаются нулями.
Любое другое значение
Формат маркера для конкретного поставщика содержится в токене.

Reserved[2]

Зарезервировано.

TokenIdLength[2]

Длина данных маркера в token.

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