struktur FSCTL_OFFLOAD_READ_OUTPUT (ntifs.h)

  • Artikel

Struktur FSCTL_OFFLOAD_READ_OUTPUT berisi output untuk permintaan kode kontrol FSCTL_OFFLOAD_READ .

Sintaks

typedef struct _FSCTL_OFFLOAD_READ_OUTPUT {
  ULONG     Size;
  ULONG     Flags;
  ULONGLONG TransferLength;
  UCHAR     Token[512];
} FSCTL_OFFLOAD_READ_OUTPUT, *PFSCTL_OFFLOAD_READ_OUTPUT;

Anggota

Size

Ukuran struktur ini. Atur anggota ini ke sizeof(FSCTL_OFFLOAD_READ_OUTPUT).

Flags

Bendera hasil. Nilai ini adalah kombinasi bitwise OR dari nilai-nilai ini:

Nilai Makna
OFFLOAD_READ_FLAG_FILE_TOO_SMALL
0x00000001
 File yang akan dibaca terlalu kecil untuk operasi offload.
OFFLOAD_READ_FLAG_ALL_ZERO_BEYOND_CURRENT_RANGE
0x00000002
 Rentang yang diperluas di luar rentang yang dipilih berisi semua nol.
OFFLOAD_READ_FLAG_CANNOT_OFFLOAD_BEYOND_CURRENT_RANGE
0x00000004
 Operasi offload tidak dapat diselesaikan di luar rentang yang dipilih. Metode baca yang tidak dibongkar harus digunakan untuk menyelesaikan operasi.

TransferLength

Panjang, dalam byte, data yang diwakili oleh Token.

Token[512]

Array byte yang berisi struktur token, STORAGE_OFFLOAD_TOKEN, mewakili data file dalam rentang yang ditentukan dalam FSCTL_OFFLOAD_READ_INPUT. Konten Token harus tetap tidak dimodifikasi antara operasi offload.

Keterangan

Jika operasi FSCTL_OFFLOAD_READ berhasil, penyedia salinan perangkat penyimpanan mengembalikan, dalam FSCTL_OFFLOAD_READ_OUTPUT, nilai token unik yang mengidentifikasi bagian data file yang dibaca.

Penyedia salinan mempertahankan data yang dibaca selama durasi di anggota TokenTimeToLive dari struktur FSCTL_OFFLOAD_READ_INPUT .

Token mewakili wilayah file yang berdampingan yang dimulai dengan offset yang diminta di anggota FileOffsetFSCTL_OFFLOAD_READ_INPUT. Panjang yang dihasilkan disalin, TransferLength, mungkin lebih kecil dari apa yang awalnya ditentukan dalam anggota CopyLengthdari FSCTL_OFFLOAD_READ_INPUT. Nilai yang lebih kecil menunjukkan bahwa Token dapat secara logis mewakili lebih sedikit data daripada yang diminta.

Jika lebih sedikit data daripada yang diminta ditransfer, operasi baca dapat diselesaikan dengan melakukan permintaan FSCTL_OFFLOAD_READ lain. Permintaan berikutnya menggunakan anggota FileOffset yang diperbarui dalam struktur FSCTL_OFFLOAD_READ_INPUT dengan nilai di TransferLength dan panjang baca yang disesuaikan dari panjang sebelumnya dikurangi nilai di TransferLength. Selain itu, operasi baca yang tidak lengkap dapat diselesaikan melalui metode baca yang tidak dibongkar, menggunakan rutinitas ZwReadFile , misalnya.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8.
Header ntifs.h (termasuk Ntifs.h, Fltkernel.h)

Lihat juga

FSCTL_OFFLOAD_READ

FSCTL_OFFLOAD_READ_INPUT

STORAGE_OFFLOAD_TOKEN