структура STORAGE_OFFLOAD_TOKEN (ntddstor.h)

Статья
02/07/2025

Структура 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 (include Ntddstor.h)

См. также

DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS

STORAGE_OFFLOAD_READ_OUTPUT

Поделиться через