DEVICE_COPY_OFFLOAD_DESCRIPTOR-Struktur (winioctl.h)

Die DEVICE_COPY_OFFLOAD_DESCRIPTOR-Struktur ist eine der Abfrageergebnisstrukturen, die von einer IOCTL_STORAGE_QUERY_PROPERTY-Anforderung zurückgegeben werden. Diese Struktur enthält die Kopierauslagerungsfunktionen für ein Speichergerät.

Syntax

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;

Member

Version

Enthält die Größe dieser Struktur in Bytes. Der Wert dieses Members ändert sich, wenn Member der -Struktur hinzugefügt werden.

Size

Gibt die Gesamtgröße der zurückgegebenen Daten in Bytes an. Dies kann Daten umfassen, die dieser Struktur folgen.

MaximumTokenLifetime

Die maximale Lebensdauer des Tokens in Sekunden.

DefaultTokenLifetime

Die Standardlebensdauer des Tokens in Sekunden.

MaximumTransferSize

Die maximale Übertragungsgröße in Bytes.

OptimalTransferCount

Die optimale Übertragungsgröße in Bytes.

MaximumDataDescriptors

Die maximale Anzahl von Datendeskriptoren.

MaximumTransferLengthPerDescriptor

Die maximale Übertragungslänge in Blöcken pro Deskriptor.

OptimalTransferLengthPerDescriptor

Die optimale Übertragungslänge pro Deskriptor.

OptimalTransferLengthGranularity

Die Granularität der optimalen Übertragungslänge in Blöcken. Übertragungslängen, die kein gerades Vielfaches dieser Länge sind, können verzögert werden.

Reserved[2]

Reserviert.

Hinweise

Diese Struktur wird von einer IOCTL_STORAGE_QUERY_PROPERTY-Anforderung zurückgegeben, wenn das PropertyId-Element von STORAGE_PROPERTY_QUERY auf StorageDeviceCopyOffloadProperty festgelegt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	winioctl.h (windows.h einschließen)

Siehe auch

Strukturen für die Datenträgerverwaltung

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_PROPERTY_QUERY