通过

NdisIfFreeNetLuidIndex 函数 (ndis.h)

  • 项目

NdisIfFreeNetLuidIndex 函数释放以前通过调用 分配的网络接口NET_LUID索引 NdisIfAllocateNetLuidIndex 函数。

语法

NDIS_STATUS NdisIfFreeNetLuidIndex(
       NET_IFTYPE ifType,
  [in] UINT32     NetLuidIndex
);

参数

ifType

为其分配索引的接口类型。 调用方必须提供它使用 NdisIfAllocateNetLuidIndex 分配NET_LUID索引时使用的相同值。 有关接口类型的列表，请参阅 NDIS 接口类型。

[in] NetLuidIndex

NDIS 应释放的NET_LUID索引值。 此索引是在上一次对 NdisIfAllocateNetLuidIndex 的调用中分配的。

返回值

NdisIfFreeNetLuidIndex 返回以下值之一：

返回代码 说明
NDIS_STATUS_SUCCESS
 操作已成功完成。
DIS_STATUS_INVALID_PARAMETER
 NdisIfFreeNetLuidIndex 失败，因为 NetLuidIndex 参数指定的索引未为 IfType 参数指定的类型分配。
 

如果对 NdisIfFreeNetLuidIndex 的调用失败，接口提供程序应删除它保存在与索引相关的持久存储中的任何信息。 删除该信息将确保提供程序不会继续尝试释放计算机重启后已释放的索引。

注解

NDIS 接口提供程序调用 NdisIfFreeNetLuidIndex 函数以释放 NET_LUID 索引。 仅当本地计算机上不再使用该接口时，接口提供程序才应释放NET_LUID索引。

NdisIfFreeNetLuidIndex 将以前分配给 NDIS 的NET_LUID索引返回，以便可能重新分配到另一个接口。 调用方必须在 IfType 中传入它在调用 时使用的同一接口类型 NdisIfAllocateNetLuidIndex 函数，用于分配NET_LUID索引。

在调用 NdisIfFreeNetLuidIndex 后，提供程序不应在任何其他 NDIS 函数调用中使用释放NET_LUID索引或关联的NET_LUID值。

要求

要求 值
最低受支持的客户端 在 NDIS 6.0 及更高版本中受支持。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI 符合性规则 Irql_Interfaces_Function (ndis)

另请参阅

NET_LUID

NdisIfAllocateNetLuidIndex