structure STORAGE_OFFLOAD_READ_OUTPUT (ntddstor.h)

  • Article

La structure STORAGE_OFFLOAD_READ_OUTPUT est la sortie d’une demande de code de contrôle IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES lorsque le membre Actiond’une structure DEVICE_DSM_INPUT est défini sur DeviceDsmAction_OffloadRead.

Un jeton retourné identifie de manière unique les plages de jeu de données demandées dans DEVICE_DSM_INPUT. Conjointement avec DEVICE_DSM_INPUT, la structure DEVICE_DSM_OFFLOAD_READ_PARAMETERS spécifie la durée pendant laquelle les plages de jeu de données identifiées par le jeton retourné restent disponibles pour l’écriture ultérieure.

Syntaxe

typedef struct _STORAGE_OFFLOAD_READ_OUTPUT {
  ULONG                 OffloadReadFlags;
  ULONG                 Reserved;
  ULONGLONG             LengthProtected;
  ULONG                 TokenLength;
  STORAGE_OFFLOAD_TOKEN Token;
} STORAGE_OFFLOAD_READ_OUTPUT, *PSTORAGE_OFFLOAD_READ_OUTPUT;

Membres

OffloadReadFlags

Non utilisé. Définit la valeur 0.

Reserved

Réservé.

LengthProtected

Longueur totale, en octets, des données lues et conservées par le fournisseur de copie pour Token.

TokenLength

Longueur, en octets, du jeton.

Token

Identificateur unique retourné par le fournisseur de copie, marquant les plages de jeu de données lues.

Remarques

La structure STORAGE_OFFLOAD_READ_OUTPUT est retournée au début de la mémoire tampon système.

La valeur de Jeton est générée par le fournisseur de copie de l’appareil de stockage. Les plages de jeu de données incluses lorsque la structure DEVICE_DSM_INPUT a été envoyée dans la demande de code de contrôle IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES sont marquées par Jeton. Les plages de jeu de données associées à Token sont disponibles pour les demandes d’écriture suivantes, tandis que la durée dans le membre TimeToLive de DEVICE_DSM_OFFLOAD_READ_PARAMETERS est valide.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows 8 et versions ultérieures de Windows.
En-tête ntddstor.h (inclure Ntddstor.h)

Voir aussi

DEVICE_DSM_OFFLOAD_READ_PARAMETERS

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES