STORAGE_OFFLOAD_TOKEN-Struktur (winioctl.h)

Enthält das Token, das verwendet wird, um einen Teil einer Datei darzustellen, die in von Lese- und Schreibvorgängen ausgelagert wird, die durch DeviceDsmAction_OffloadRead - oder DeviceDsmAction_OffloadWrite-Aktionen für den IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES-Steuerelementcode angegeben werden.

Syntax

typedef struct _STORAGE_OFFLOAD_TOKEN {
  BYTE  TokenType[4];
  BYTE  Reserved[2];
  BYTE  TokenIdLength[2];
  union {
    struct {
      BYTE Reserved2[STORAGE_OFFLOAD_TOKEN_ID_LENGTH];
    } StorageOffloadZeroDataToken;
    BYTE Token[STORAGE_OFFLOAD_TOKEN_ID_LENGTH];
  } DUMMYUNIONNAME;
} STORAGE_OFFLOAD_TOKEN, *PSTORAGE_OFFLOAD_TOKEN;

Member

TokenType[4]

Eine 32-Bit-Ganzzahl ohne Vorzeichen, die den Tokentyp definiert.

STORAGE_OFFLOAD_TOKEN_TYPE_WELL_KNOWN (0xFFFFFFFF)

Das Tokenelement verwendet ein bekanntes Format. Die ersten beiden Bytes des Tokenelements sind eine 16-Bit-Ganzzahl ohne Vorzeichen, die den Bereich beschreibt. Die möglichen Werte sind entweder STORAGE_OFFLOAD_PATTERN_ZERO oder STORAGE_OFFLOAD_PATTERN_ZERO_WITH_PROTECTION_INFO. STORAGE_OFFLOAD_PATTERN_ZERO (0x0001) ist ein bekanntes Token, das angibt, dass für den dargestellten Bereich alle Bits auf Null festgelegt sind. STORAGE_OFFLOAD_PATTERN_ZERO_WITH_PROTECTION_INFO ist ein bekanntes Token, das angibt, dass für die Daten in der dargestellten Region alle Bits auf Null festgelegt sind und die entsprechenden Schutzinformationen gültig sind.

0x00000000–0xFFFFFFFE

Das Tokenmitglied verwendet ein anbieterspezifisches Format.

Reserved[2]

Reserviert.

TokenIdLength[2]

Die Länge der Tokendaten in Token.

DUMMYUNIONNAME

DUMMYUNIONNAME.StorageOffloadZeroDataToken

DUMMYUNIONNAME.StorageOffloadZeroDataToken.Reserved2[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

Reserviert.

DUMMYUNIONNAME.Token[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

Wenn das TokenType-ElementSTORAGE_OFFLOAD_TOKEN_TYPE_WELL_KNOWN dann sind die ersten beiden Bytes eine 16-Bit-Ganzzahl ohne Vorzeichen, die den Bereich beschreibt. Andernfalls handelt es sich um ein herstellerspezifisches Format.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Kopfzeile	winioctl.h (windows.h einschließen)