通过

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 将以前分配的NET_LUID索引返回到 NDIS，以便可能重新分配给另一个接口。 调用方必须在 IfType 处传入同一接口类型， 它在调用 IfType 时使用的接口类型 NdisIfAllocateNetLuidIndex 函数来分配NET_LUID索引。

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

要求

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

另请参阅

NET_LUID

NdisIfAllocateNetLuidIndex