DEVICE_COPY_OFFLOAD_DESCRIPTOR structure (winioctl.h)

  • Article

La structure DEVICE_COPY_OFFLOAD_DESCRIPTOR est l’une des structures de résultats de requête retournées par une requête IOCTL_STORAGE_QUERY_PROPERTY . Cette structure contient les fonctionnalités de déchargement de copie pour un périphérique de stockage.

Syntaxe

typedef struct _DEVICE_COPY_OFFLOAD_DESCRIPTOR {
  DWORD     Version;
  DWORD     Size;
  DWORD     MaximumTokenLifetime;
  DWORD     DefaultTokenLifetime;
  DWORDLONG MaximumTransferSize;
  DWORDLONG OptimalTransferCount;
  DWORD     MaximumDataDescriptors;
  DWORD     MaximumTransferLengthPerDescriptor;
  DWORD     OptimalTransferLengthPerDescriptor;
  WORD      OptimalTransferLengthGranularity;
  BYTE      Reserved[2];
} DEVICE_COPY_OFFLOAD_DESCRIPTOR, *PDEVICE_COPY_OFFLOAD_DESCRIPTOR;

Membres

Version

Contient la taille de cette structure, en octets. La valeur de ce membre change à mesure que des membres sont ajoutés à la structure.

Size

Spécifie la taille totale des données retournées, en octets. Cela peut inclure des données qui suivent cette structure.

MaximumTokenLifetime

Durée de vie maximale du jeton, en secondes.

DefaultTokenLifetime

Durée de vie par défaut du jeton, en secondes.

MaximumTransferSize

Taille de transfert maximale, en octets.

OptimalTransferCount

Taille de transfert optimale, en octets.

MaximumDataDescriptors

Nombre maximal de descripteurs de données.

MaximumTransferLengthPerDescriptor

Longueur de transfert maximale, en blocs, par descripteur.

OptimalTransferLengthPerDescriptor

Longueur de transfert optimale par descripteur.

OptimalTransferLengthGranularity

Granularité de la longueur de transfert optimale, en blocs. Les longueurs de transfert qui ne sont pas un multiple pair de cette longueur peuvent être retardées.

Reserved[2]

Réservé.

Remarques

Cette structure est retournée à partir d’une demande de IOCTL_STORAGE_QUERY_PROPERTY lorsque le membre PropertyId de STORAGE_PROPERTY_QUERY est défini sur StorageDeviceCopyOffloadProperty.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
En-tête winioctl.h (inclure Windows.h)

Voir aussi

Structures de gestion des disques

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_PROPERTY_QUERY