struktur SCATTER_GATHER_LIST (wdm.h)

  • Artikel

Struktur SCATTER_GATHER_LIST menjelaskan daftar sebar/kumpulkan untuk operasi DMA.

Sintaks

typedef struct _SCATTER_GATHER_LIST {
  ULONG                  NumberOfElements;
  ULONG_PTR              Reserved;
  SCATTER_GATHER_ELEMENT Elements[];
} SCATTER_GATHER_LIST, *PSCATTER_GATHER_LIST;

Anggota

NumberOfElements

Menentukan jumlah elemen dalam array Elemen .

Reserved

Disiapkan untuk penggunaan masa mendatang.

Elements

Menentukan array elemen sebar/kumpulkan yang terdiri dari daftar sebar/kumpulkan. Setiap elemen array adalah struktur jenis SCATTER_GATHER_ELEMENT, yang didefinisikan sebagai berikut:

typedef struct _SCATTER_GATHER_ELEMENT {
  PHYSICAL_ADDRESS  Address;
  ULONG  Length;
  ULONG_PTR  Reserved;
} SCATTER_GATHER_ELEMENT, *PSCATTER_GATHER_ELEMENT;

Struktur SCATTER_GATHER_ELEMENT menentukan panjang, dalam byte, dari wilayah sebar/kumpulkan yang berdekatan secara fisik dan alamat fisik awal wilayah ini.

Keterangan

Untuk driver yang melakukan sebar/kumpulkan DMA, rutinitas GetScatterGatherList atau BuildScatterGatherList membuat daftar sebar/kumpulkan dan meneruskan daftar ini ke rutinitas AdapterListControl driver. Daftar sebar/kumpulkan ini terdiri dari struktur SCATTER_GATHER_LIST yang segera diikuti dalam memori oleh array SCATTER_GATHER_ELEMENT . Jumlah elemen dalam array ini ditentukan oleh anggota NumberOfElements dari struktur SCATTER_GATHER_LIST .

Untuk informasi selengkapnya tentang daftar sebar/kumpulkan, lihat Menggunakan Sebar/Kumpulkan DMA.

Persyaratan

Persyaratan Nilai
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

AdapterListControl

BuildScatterGatherList

GetScatterGatherList