struktur SPB_TRANSFER_BUFFER (spb.h)

  • Artikel

Struktur SPB_TRANSFER_BUFFER menjelaskan buffer data untuk transfer individu dalam urutan transfer I/O.

Sintaks

typedef struct SPB_TRANSFER_BUFFER {
  SPB_TRANSFER_BUFFER_FORMAT Format;
  union {
    SPB_TRANSFER_BUFFER_LIST_ENTRY Simple;
    struct {
      PSPB_TRANSFER_BUFFER_LIST_ENTRY List;
      ULONG                           ListCe;
    } BufferList;
    PMDL                           Mdl;
  };
} SPB_TRANSFER_BUFFER, *PSPB_TRANSFER_BUFFER;

Anggota

Format

Format buffer. Anggota ini diatur ke salah satu nilai enumerasi SPB_TRANSFER_BUFFER_FORMAT berikut:

  • SpbTransferBufferFormatSimple
  • SpbTransferBufferFormatList
  • SpbTransferBufferFormatSimpleNonPaged
  • SpbTransferBufferFormatMdl

SpbTransferBufferFormatMdl adalah nilai yang valid hanya untuk urutan transfer I/O yang diminta oleh klien driver pengontrol SPB yang merupakan komponen mode kernel.

Simple

Struktur SPB_TRANSFER_BUFFER_LIST_ENTRY yang menentukan alamat dasar dan panjang buffer transfer sederhana. Gunakan anggota gabungan ini jika Format adalah SpbTransferBufferFormatSimple atau SpbTransferBufferFormatSimpleNonPaged. Format SpbTransferBufferFormatSimpleNonPaged hanya digunakan oleh klien mode kernel.

BufferList

Daftar pengumpulan sebar yang terdiri dari array deskriptor buffer. Gunakan anggota union ini jika Format adalah SpbTransferBufferFormatList.

BufferList.List

Penunjuk ke array struktur SPB_TRANSFER_BUFFER_LIST_ENTRY yang menjelaskan buffer dalam daftar pengumpulan sebar.

BufferList.ListCe

Jumlah elemen dalam array Daftar .

Mdl

Penunjuk ke MDL yang menjelaskan buffer. Anggota ini hanya digunakan oleh klien mode kernel. Gunakan anggota gabungan ini jika Format adalah SpbTransferBufferFormatMdl. Untuk informasi selengkapnya, lihat Keterangan.

Keterangan

Struktur ini digunakan oleh struktur SPB_TRANSFER_LIST_ENTRY untuk menjelaskan buffer transfer.

Anggota Mdl dari struktur ini hanya dapat digunakan oleh klien driver pengontrol SPB yang merupakan komponen mode kernel. Klien mode pengguna tidak boleh menggunakan anggota ini. Untuk informasi selengkapnya tentang MDL, lihat Menggunakan MDL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung dimulai dengan Windows 8.
Header spb.h

Lihat juga