SCATTER_GATHER_LIST 結構 (wdm.h)
SCATTER_GATHER_LIST結構描述 DMA 作業的散佈/收集清單。
語法
typedef struct _SCATTER_GATHER_LIST {
ULONG NumberOfElements;
ULONG_PTR Reserved;
SCATTER_GATHER_ELEMENT Elements[];
} SCATTER_GATHER_LIST, *PSCATTER_GATHER_LIST;
成員
NumberOfElements
指定 Elements 陣列中的項目數目。
Reserved
保留供未來使用。
Elements
指定構成散佈/收集清單的散佈/收集元素陣列。 每個陣列元素都是 類型SCATTER_GATHER_ELEMENT的結構，其定義如下：
typedef struct _SCATTER_GATHER_ELEMENT {
PHYSICAL_ADDRESS Address;
ULONG Length;
ULONG_PTR Reserved;
} SCATTER_GATHER_ELEMENT, *PSCATTER_GATHER_ELEMENT;
SCATTER_GATHER_ELEMENT 結構會指定實體連續散佈/收集區域的長度，以位元組為單位，以及此區域的起始實體位址。
備註
對於執行散佈/收集 DMA 的驅動程式， GetScatterGatherList 或 BuildScatterGatherList 例程會建立散佈/收集清單，並將此列表傳遞至驅動程式的 AdapterListControl 例程。 這個散佈/收集清單是由SCATTER_GATHER_ELEMENT陣列緊接在記憶體中的SCATTER_GATHER_LIST結構所組成。 這個陣列中的項目數目是由SCATTER_GATHER_LIST結構的 NumberOfElements 成員所指定。
如需散佈/收集清單的詳細資訊，請參閱 使用散佈圖/收集 DMA。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |