NdisIfAddIfStackEntry 函数指定 NDIS 网络接口堆栈中两个网络接口的顺序。
语法
NDIS_STATUS NdisIfAddIfStackEntry(
[in] NET_IFINDEX HigherLayerIfIndex,
[in] NET_IFINDEX LowerLayerIfIndex
);
参数
[in] HigherLayerIfIndex
接口的网络接口索引,该接口在接口堆栈表中应更高。
[in] LowerLayerIfIndex
接口的网络接口索引,该接口应在接口堆栈表中较低。
返回值
NdisIfAddIfStackEntry 返回以下状态值之一:
返回代码 | 描述 |
---|---|
|
作已成功完成。 |
|
作由于资源不足而失败。 |
|
NdisIfAddIfStackEntry 失败,因为 HigherLayerIfIndex 或 LowerLayerIfIndex 的索引不是已注册接口的索引。 |
言论
NDIS 驱动程序可以调用 NdisIfAddIfStackEntry 函数来指定 NDIS 接口堆栈中两个网络接口的排序。 NDIS 代理提供程序指定筛选器模块和微型端口适配器的顺序。 NDIS 还指定虚拟微型端口与筛选器中间驱动程序的基础微型端口适配器之间的关系。 但是,NDIS 未指定 MUX 中间驱动程序的堆栈顺序。
NDIS 维护接口堆栈表(ifStackTable 从 RFC 2863)。 NDIS 提供 NdisIfAddIfStackEntry 和 NdisIfDeleteIfStackEntry 函数来添加和删除此表中的条目。
任何可以提供两个接口之间的堆栈顺序关系信息的驱动程序都应调用 NdisIfAddIfStackEntry 来填充接口堆栈表。 取消注册接口时,NDIS 将删除接口的相应堆栈条目。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | NDIS 6.0 及更高版本中受支持。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
库 | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | Irql_Interfaces_Function(ndis) |