通过

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

指定 元素 数组中的元素数。

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）

另请参阅

AdapterListControl

BuildScatterGatherList

GetScatterGatherList