NdisFIndicateReceiveNetBufferLists 函数 （ndis.h）
筛选器驱动程序调用 NdisFIndicateReceiveNetBufferLists 来指示它已收到网络数据。 有关详细信息，请参阅 接收筛选器驱动程序中的数据。
语法
void NdisFIndicateReceiveNetBufferLists(
[in] NDIS_HANDLE NdisFilterHandle,
[in] PNET_BUFFER_LIST NetBufferLists,
[in] NDIS_PORT_NUMBER PortNumber,
[in] ULONG NumberOfNetBufferLists,
[in] ULONG ReceiveFlags
);
参数
[in] NdisFilterHandle
标识此筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。
[in] NetBufferLists
NET_BUFFER_LIST 结构的链接列表。 每个 NET_BUFFER_LIST 结构都包含一个 NET_BUFFER 结构。
[in] PortNumber
标识微型端口适配器端口的端口号。 通过调用 NdisMAllocatePort 函数来分配微型端口适配器端口号。 零值标识微型端口适配器的默认端口。
[in] NumberOfNetBufferLists
NetBufferLists 中结构链接列表中的 NET_BUFFER_LIST 结构的数目。
[in] ReceiveFlags
定义接收指示的属性的标志。 标志可以与 OR作结合使用。 若要清除所有标志，请将此成员设置为零。 此函数支持以下标志：
NDIS_RECEIVE_FLAGS_DISPATCH_LEVEL
指定当前 IRQL DISPATCH_LEVEL。 有关此标志的详细信息，请参阅 调度 IRQL 跟踪。
NDIS_RECEIVE_FLAGS_RESOURCES
指定筛选器驱动程序在调用 NdisFIndicateReceiveNetBufferLists 返回后立即回收 NET_BUFFER_LIST 结构的所有权和任何附加 NET_BUFFER 结构。
NDIS_RECEIVE_FLAGS_SINGLE_ETHER_TYPE
指定 NetBufferLists 列表中的所有 NET_BUFFER_LIST 结构 具有相同的协议类型（EtherType）。
NDIS_RECEIVE_FLAGS_SINGLE_VLAN
指定 NetBufferLists 列表中的所有 NET_BUFFER_LIST 结构 都属于同一 VLAN。
NDIS_RECEIVE_FLAGS_PERFECT_FILTERED
指定 NetBufferLists 列表中的所有 NET_BUFFER_LIST 结构 仅包含与分配给微型端口适配器的数据包筛选器和多播地址列表匹配的数据。
NDIS_RECEIVE_FLAGS_SINGLE_QUEUE
指定 NetBufferLists 列表中的所有 NET_BUFFER_LIST 结构 都属于同一 VM 队列。 如果 NDIS_RECEIVE_QUEUE_PARAMETERS_PER_QUEUE_RECEIVE_INDICATION 标志在 标志 成员中设置了 NDIS_RECEIVE_QUEUE_PARAMETERS_PER_QUEUE_RECEIVE_INDICATION 标志，则微型端口驱动程序必须为队列上的所有接收指示设置此标志分配队列时 NDIS_RECEIVE_QUEUE_PARAMETERS 结构。
NDIS_RECEIVE_FLAGS_SHARED_MEMORY_INFO_VALID
指定 NetBufferLists 列表中的所有 NET_BUFFER_LIST 结构 包含有效的共享内存信息。 在收到的 NET_BUFFER_LIST上设置此标志时，NDIS 会将共享内存信息视为有效。 如果未设置此标志，NDIS 和驱动程序将忽略共享内存信息。 例如，修改数据包数据的中间驱动程序可以使用此标志来确定是否应复制数据。 微型端口驱动程序可以使用标志来确定在删除队列时如何释放与 VM 队列关联的内存。
NDIS_RECEIVE_FLAGS_MORE_NBLS
保留。
NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE
如果设置了此标志，则 NET_BUFFER_LIST 结构的链接列表中的所有数据包都源自同一 Hyper-V 可扩展交换机源端口。
有关详细信息，请参阅 Hyper-V 可扩展交换机发送和接收标志。
NDIS_RECEIVE_FLAGS_SWITCH_DESTINATION_GROUP
如果设置了此标志，则 NET_BUFFER_LIST 结构链接列表中的所有数据包都将转发到同一可扩展交换机目标端口。
有关详细信息，请参阅 Hyper-V 可扩展交换机发送和接收标志。
返回值
没有
言论
当筛选器驱动程序调用 NdisFIndicateReceiveNetBufferLists 函数时，它会指定 NetBufferLists 参数中的 NET_BUFFER_LIST 结构列表。 NDIS 将 NET_BUFFER_LIST 结构传递给过度的驱动程序。
筛选器驱动程序可以调用 NdisFIndicateReceiveNetBufferLists 来发起接收指示。
筛选器驱动程序还可以筛选来自基础驱动程序的接收指示。 NDIS 调用 FilterReceiveNetBufferLists 函数来筛选此类接收指示。
筛选器驱动程序必须设置 SourceHandle 其源自 NdisFilterHandle 参数的每个 NET_BUFFER_LIST 结构的成员。 筛选器驱动程序不得修改其未发起的任何 NET_BUFFER_LIST 结构中的 SourceHandle 成员。
筛选器驱动程序必须正确初始化 NET_BUFFER_LIST 结构、附加 NET_BUFFER 结构和任何附加的 MDL。
如果筛选器驱动程序调用 NdisFIndicateReceiveNetBufferLists 函数并清除 ReceiveFlags 参数中的 NDIS_RECEIVE_FLAG_RESOURCES 标志，NDIS 会将指示 NET_BUFFER_LIST 结构返回到筛选器驱动程序的 FilterReturnNetBufferLists 函数。 在这种情况下，筛选器驱动程序不得回收 NET_BUFFER_LIST 结构，直到 NDIS 返回 NET_BUFFER_LIST 结构以 FilterReturnNetBufferLists。
如果筛选器驱动程序调用 NdisFIndicateReceiveNetBufferLists 并在 ReceiveFlags 参数中设置 NDIS_RECEIVE_FLAG_RESOURCES 标志，则表明筛选器驱动程序必须立即重新获得 NET_BUFFER_LIST 结构的所有权。 在这种情况下，NDIS 不调用筛选器驱动程序的 FilterReturnNetBufferLists 函数以返回 NET_BUFFER_LIST 结构。 相反，NDIS 在从 NdisFIndicateReceiveNetBufferLists返回时，将 NET_BUFFER_LIST 结构返回到筛选器驱动程序。 筛选器驱动程序应在 NdisFIndicateReceiveNetBufferLists 返回后立即回收 NET_BUFFER_LIST 结构。 若要回收 NET_BUFFER_LIST 结构，筛选器驱动程序可以调用其自己的 FilterReturnNetBufferLists 函数。
在 ReceiveFlags 中设置 NDIS_RECEIVE_FLAG_RESOURCES 标志 参数强制过度驱动程序复制网络数据并将 NET_BUFFER_LIST 结构释放到筛选器驱动程序。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | NDIS 6.0 及更高版本中受支持。 |
| 目标平台 | 桌面 |
| 标头 | ndis.h （包括 Ndis.h） |
| 库 | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | Irql_Filter_Driver_Function（ndis） |