structure STORAGE_OFFLOAD_TOKEN (ntddstor.h)

Article
02/07/2025

La structure STORAGE_OFFLOAD_TOKEN contient une valeur de jeton qui sert de représentation d’une plage de jeu de données au sein d’un fichier sur un volume. Cette structure est utilisée pour effectuer des lectures et des écritures de déchargement.

Syntaxe

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;

Membres

TokenType[4]

Type de jeton contenu dans cette structure. TokenType est défini sur l’une des valeurs suivantes :

Valeur	Signification
STORAGE_OFFLOAD_TOKEN_TYPE_ZERO_DATA	Un format de jeton connu est contenu dans jeton. Le jeton représente les données considérées comme toutes les zéros.
Toute autre valeur	Un format de jeton spécifique au fournisseur est contenu dans jeton.

Reserved[2]

Réservé.

TokenIdLength[2]

Longueur des données de jeton dans jeton.

DUMMYUNIONNAME

DUMMYUNIONNAME.StorageOffloadZeroDataToken

Valeur du jeton lorsque les données qu’elle représente sont considérées comme toutes les zéros. Ce membre est valide lorsque TokenType est défini sur STORAGE_OFFLOAD_TOKEN_TYPE_ZERO_DATA.

DUMMYUNIONNAME.StorageOffloadZeroDataToken.Reserved2[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

Réservé.

DUMMYUNIONNAME.Token[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

Valeur de jeton fournie par le fournisseur représentant une plage de jeu de données pour une opération de lecture ou d’écriture de déchargement.

Remarques

Les informations de jeton contenues dans STORAGE_OFFLOAD_TOKEN sont générées par l’infrastructure de chargement en lecture/écriture. Tous les membres de cette structure doivent être considérés comme lus uniquement et ne doivent pas être modifiés par les appelants demandant une lecture de déchargement ou une écriture de déchargement.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
d’en-tête	ntddstor.h (include Ntddstor.h)

Voir aussi

DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS

STORAGE_OFFLOAD_READ_OUTPUT

Partager via