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) |