struktur STORAGE_OFFLOAD_TOKEN (winioctl.h)

Artikel
08/27/2023

Berisi token yang digunakan untuk mewakili sebagian file yang digunakan dalam dengan operasi baca dan tulis offload yang ditentukan oleh tindakan DeviceDsmAction_OffloadRead atau DeviceDsmAction_OffloadWrite untuk kode kontrol IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .

Sintaks

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;

Anggota

TokenType[4]

Bilangan bulat 32-bit yang tidak ditandatangani yang menentukan jenis Token.

STORAGE_OFFLOAD_TOKEN_TYPE_WELL_KNOWN (0xFFFFFFFF)

Anggota Token menggunakan format terkenal. Dua byte pertama anggota Token adalah bilangan bulat 16-bit yang tidak ditandatangani yang menjelaskan wilayah tersebut. Nilai yang mungkin STORAGE_OFFLOAD_PATTERN_ZERO atau STORAGE_OFFLOAD_PATTERN_ZERO_WITH_PROTECTION_INFO. STORAGE_OFFLOAD_PATTERN_ZERO (0x0001) adalah token terkenal yang menunjukkan bahwa wilayah yang diwakili memiliki semua bit yang diatur ke nol. STORAGE_OFFLOAD_PATTERN_ZERO_WITH_PROTECTION_INFO adalah token terkenal yang menunjukkan bahwa data di wilayah yang diwakili memiliki semua bit yang diatur ke nol dan informasi perlindungan yang sesuai valid.

0x00000000–0xFFFFFFFE

Anggota Token menggunakan format khusus vendor.

Reserved[2]

Dicadangkan.

TokenIdLength[2]

Panjang data token dalam Token.

DUMMYUNIONNAME

DUMMYUNIONNAME.StorageOffloadZeroDataToken

DUMMYUNIONNAME.StorageOffloadZeroDataToken.Reserved2[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

Dicadangkan.

DUMMYUNIONNAME.Token[STORAGE_OFFLOAD_TOKEN_ID_LENGTH]

Jika anggota TokenTypeSTORAGE_OFFLOAD_TOKEN_TYPE_WELL_KNOWN maka dua byte pertama adalah bilangan bulat tidak bertanda 16-bit yang menjelaskan rentang. Jika tidak, ini adalah format khusus vendor.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Header	winioctl.h (termasuk Windows.h)