NdisFIndicateReceiveNetBufferLists 函数 (ndis.h)

项目
08/07/2023

筛选器驱动程序调用 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

指定 DISPATCH_LEVEL当前 IRQL。有关此标志的详细信息，请参阅 Dispatch IRQL Tracking。

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 队列。如果在的 Flags 成员中设置了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 可扩展交换机发送和接收标志。

注意如果NET_BUFFER_LIST结构链接列表中的每个数据包使用相同的源端口，则当接收请求完成时，扩展应在 FilterReturnNetBufferLists 的 ReturnFlags 参数中设置NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE标志。如果扩展调用 NdisFReturnNetBufferLists 以返回它未源自或克隆的数据包，则必须在 ReturnFlags 参数中设置此标志。

NDIS_RECEIVE_FLAGS_SWITCH_DESTINATION_GROUP

如果设置了此标志，则NET_BUFFER_LIST 结构链接列表中的所有数据包都将转发到同一可扩展交换机目标端口。

有关详细信息，请参阅 Hyper-V 可扩展交换机发送和接收标志。

返回值

无

备注

当筛选器驱动程序调用 NdisFIndicateReceiveNetBufferLists 函数时，它会在 NetBufferLists 参数中指定NET_BUFFER_LIST结构的列表。 NDIS 将 NET_BUFFER_LIST 结构传递给覆盖驱动程序。

筛选器驱动程序可以调用 NdisFIndicateReceiveNetBufferLists 来产生接收指示。

筛选器驱动程序还可以筛选基础驱动程序发起的接收指示。 NDIS 调用 FilterReceiveNetBufferLists 函数用于筛选此类接收指示。

筛选器驱动程序必须将它源自的每个NET_BUFFER_LIST结构的 SourceHandle 成员设置为与 NdisFilterHandle 参数相同的值。筛选器驱动程序不得修改其未源自的任何NET_BUFFER_LIST结构中的 SourceHandle 成员。

筛选器驱动程序必须正确初始化 NET_BUFFER_LIST 结构、附加 NET_BUFFER 结构和任何附加的 MDL。

如果筛选器驱动程序调用 NdisFIndicateReceiveNetBufferLists 函数并清除 ReceiveFlags 参数中的NDIS_RECEIVE_FLAG_RESOURCES标志，则 NDIS 会将指示的NET_BUFFER_LIST结构返回到筛选器驱动程序的 FilterReturnNetBufferLists 函数。在这种情况下，在 NDIS 将NET_BUFFER_LIST结构返回到 FilterReturnNetBufferLists 之前，筛选器驱动程序不得回收NET_BUFFER_LIST结构。

如果筛选器驱动程序调用 NdisFIndicateReceiveNetBufferLists 并在 ReceiveFlags 参数中设置NDIS_RECEIVE_FLAG_RESOURCES标志，则表示筛选器驱动程序必须立即重新获得NET_BUFFER_LIST结构的所有权。在这种情况下，NDIS 不会调用筛选器驱动程序的 FilterReturnNetBufferLists 函数来返回 NET_BUFFER_LIST 结构。相反，从 NdisFIndicateReceiveNetBufferLists 返回时，NDIS 会将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)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 符合性规则	Irql_Filter_Driver_Function (ndis)