STORAGE_OFFLOAD_TOKEN-Struktur (ntddstor.h)

Artikel
02/29/2024

Die STORAGE_OFFLOAD_TOKEN-Struktur enthält einen Tokenwert, der als Darstellung eines Datasetbereichs innerhalb einer Datei auf einem Volume dient. Diese Struktur wird zum Ausführen von Lese- und Schreibvorgängen verwendet.

Syntax

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;

Member

TokenType[4]

Der In dieser Struktur enthaltene Tokentyp. TokenType ist auf eine der folgenden Optionen festgelegt:

Wert	Bedeutung
STORAGE_OFFLOAD_TOKEN_TYPE_ZERO_DATA	Ein bekanntes Tokenformat ist in Token enthalten. Das Token stellt Daten dar, die als alle Nullen betrachtet werden.
Beliebige andere Werte	Ein anbieterspezifisches Tokenformat ist in Token enthalten.

Reserved[2]

Reserviert.

TokenIdLength[2]

Die Länge der Tokendaten in Token.

DUMMYUNIONNAME

DUMMYUNIONNAME.StorageOffloadZeroDataToken

Der Tokenwert, wenn die dargestellten Daten als alle Nullen betrachtet werden. Dieser Member ist gültig, wenn TokenType auf STORAGE_OFFLOAD_TOKEN_TYPE_ZERO_DATA festgelegt ist.

DUMMYUNIONNAME.StorageOffloadZeroDataToken.Reserved2[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

Reserviert.

DUMMYUNIONNAME.Token[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

Der vom Anbieter bereitgestellte Tokenwert, der einen Datasetbereich für einen Lese- oder Schreibvorgang darstellt.

Hinweise

Die in STORAGE_OFFLOAD_TOKEN enthaltenen Tokeninformationen werden von der Auslagerungsinfrastruktur mit Lese-/Schreibzugriff generiert. Alle Elemente dieser Struktur sollten als schreibgeschützt betrachtet werden und dürfen nicht von Aufrufern geändert werden, die einen Lese- oder Offload-Schreibvorgang anfordern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Kopfzeile	ntddstor.h (include Ntddstor.h)

Weitere Informationen

DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS

STORAGE_OFFLOAD_READ_OUTPUT

Freigeben über