NdisFReturnNetBufferLists 函数 (ndis.h)
筛选器驱动程序调用 NdisFReturnNetBufferLists 以释放一个或多个 NET_BUFFER_LIST 结构及其关联的 NET_BUFFER 结构的所有权。
语法
void NdisFReturnNetBufferLists(
[in] NDIS_HANDLE NdisFilterHandle,
[in] PNET_BUFFER_LIST NetBufferLists,
[in] ULONG ReturnFlags
);
参数
[in] NdisFilterHandle
标识此筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。
[in] NetBufferLists
指向要返回到基础驱动程序的NET_BUFFER_LIST结构链接列表的指针。 链接列表可以包含以前对 的多个调用NET_BUFFER_LIST结构 FilterReceiveNetBufferLists 函数。
[in] ReturnFlags
可与 OR 操作组合的 NDIS 标志。 若要清除所有标志,请将此成员设置为零。此函数支持以下标志:
NDIS_RETURN_FLAGS_DISPATCH_LEVEL
指定当前 IRQL DISPATCH_LEVEL。 有关此标志的详细信息,请参阅 Dispatch IRQL Tracking。
NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE
如果设置了此标志, 则NET_BUFFER_LIST 结构的链接列表中的所有数据包都源自同一 Hyper-V 可扩展交换机源端口。
有关详细信息,请参阅 Hyper-V 可扩展交换机发送和接收标志。
返回值
无
备注
如果 NDIS 传递给 的 ReceiveFlags 参数中NDIS_RECEIVE_FLAGS_RESOURCES标志 FilterReceiveNetBufferLists 函数未设置,筛选器驱动程序必须调用 NdisFReturnNetBufferLists 函数以返回 NET_BUFFER_LIST 结构和关联的数据。 在筛选器驱动程序调用 NdisFReturnNetBufferLists 后,NDIS 将数据返回到基础驱动程序。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 NDIS 6.0 及更高版本中受支持。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
Library | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_Filter_Driver_Function (ndis) |