struktur SCATTER_GATHER_LIST (wdm.h)
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) |