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 結構所組成。 此陣列中的元素數目是由 NumberOfElementsSCATTER_GATHER_LIST 結構的成員所指定。
如需散佈/收集清單的詳細資訊,請參閱使用散佈圖/收集 DMA 。
要求
要求 | 價值 |
---|---|
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |