NDIS_SCATTER_GATHER_LIST_PARAMETERS 结构 (ndis.h)

  • 项目

NDIS_SCATTER_GATHER_LIST_PARAMETERS 结构指定 NDIS 用于为缓冲区生成散点/收集列表的参数。

语法

typedef struct _NDIS_SCATTER_GATHER_LIST_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_RECEIVE_QUEUE_ID        QueueId;
  NDIS_SHARED_MEMORY_USAGE     SharedMemoryUsage;
  PMDL                         Mdl;
  PVOID                        CurrentVa;
  ULONG                        Length;
  NDIS_PROCESS_SG_LIST_HANDLER ProcessSGListHandler;
  PVOID                        Context;
  PSCATTER_GATHER_LIST         ScatterGatherListBuffer;
  ULONG                        ScatterGatherListBufferSize;
  ULONG                        ScatterGatherListBufferSizeNeeded;
} NDIS_SCATTER_GATHER_LIST_PARAMETERS, *PNDIS_SCATTER_GATHER_LIST_PARAMETERS;

成员

Header

结构 (NDIS_SCATTER_GATHER_LIST_PARAMETERS) 的NDIS_OBJECT_HEADER结构。 驱动程序将 Header 指定的结构的 Type 成员设置为 NDIS_OBJECT_TYPE_DEFAULT，将 Revision 成员设置为 NDIS_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1，将 Size 成员设置为 NDIS_SIZEOF_SCATTER_GATHER_LIST_PARAMETERS_REVISION_1。

Flags

保留给 NDIS。

QueueId

包含队列标识符NDIS_RECEIVE_QUEUE_ID类型值。 队列标识符是介于零和微型端口适配器支持的队列数之间的整数。 零值表示默认队列。

SharedMemoryUsage

一个NDIS_SHARED_MEMORY_USAGE枚举值，该值指定共享内存的用途。

Mdl

指向内存描述符列表的指针 (描述共享内存缓冲区的 MDL) 。

CurrentVa

当前虚拟地址的 ULONG 值。

Length

一个 ULONG 值，该值包含共享内存缓冲区的长度（以字节为单位）。

ProcessSGListHandler

指向 NetProcessSGList 函数的指针 (NDIS_PROCESS_SG_LIST_HANDLER 入口点) 。

Context

指向驱动程序分配的上下文信息块的指针，该块存储有关散点/收集列表的信息。 NDIS 在调用 NetProcessSGList 时通过 Context 参数传递 上下文 信息。

ScatterGatherListBuffer

指向 SCATTER_GATHER_LIST 结构的指针。

ScatterGatherListBufferSize

一个 ULONG 值，该值包含散点/收集列表的长度（以字节为单位）。

ScatterGatherListBufferSizeNeeded

ULONG 值，其中 NDIS 写入 NDIS 成功生成散点/收集列表所需的字节总数。

注解

若要生成散点/收集列表，NDIS 驱动程序会将NDIS_SCATTER_GATHER_LIST_PARAMETERS结构传递给 NdisBuildScatterGatherList 函数。

要求

要求 值
最低受支持的客户端 在 NDIS 6.20 及更高版本中受支持。
标头 ndis.h (包括 Ndis.h)

另请参阅

NDIS_OBJECT_HEADER

NDIS_SHARED_MEMORY_USAGE

NdisBuildScatterGatherList

NetProcessSGList

SCATTER_GATHER_LIST