STORAGE_OFFLOAD_TOKEN structure (ntddstor.h)

Article
02/26/2024

La structure STORAGE_OFFLOAD_TOKEN contient une valeur de jeton qui sert de représentation d’une plage de jeu de données dans 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 tous 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

La valeur du jeton quand les données qu’il représente est considérée comme tous 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 lecture/écriture de déchargement. Tous les membres de cette structure doivent être considérés comme en lecture seule et ne doivent pas être modifiés par les appelants qui demandent une lecture de déchargement ou une écriture de déchargement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
En-tête	ntddstor.h (inclure Ntddstor.h)

Voir aussi

DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS

STORAGE_OFFLOAD_READ_OUTPUT

Partager via