NDIS_SWITCH_DEREFERENCE_SWITCH_NIC回调函数 (ndis.h)

  • 项目

DereferenceSwitchNic 函数递减连接到可扩展交换机端口的网络适配器的 Hyper-V 可扩展交换机引用计数器。 引用计数器是通过之前对 ReferenceSwitchNic 的调用递增的。

语法

NDIS_SWITCH_DEREFERENCE_SWITCH_NIC NdisSwitchDereferenceSwitchNic;

NDIS_STATUS NdisSwitchDereferenceSwitchNic(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId,
  [in] NDIS_SWITCH_NIC_INDEX SwitchNicIndex
)
{...}

参数

[in] NdisSwitchContext

一个 NDIS_SWITCH_CONTEXT 值，该值包含 Hyper-V 可扩展交换机扩展所附加到的可扩展交换机模块的句柄。 当扩展调用 NdisFGetOptionalSwitchHandlers 时，此句柄通过 NdisSwitchContext 参数返回。

[in] SwitchPortId

一个 NDIS_SWITCH_PORT_ID 值，该值包含虚拟网络适配器连接到的可扩展交换机端口的唯一标识符。

[in] SwitchNicIndex

一个 NDIS_SWITCH_NIC_INDEX 值，该值指定要递增可扩展交换机引用计数器的虚拟网络适配器的索引。

有关NDIS_SWITCH_NIC_INDEX值的详细信息，请参阅 网络适配器索引值。

返回值

如果调用成功，该函数将返回NDIS_STATUS_SUCCESS。 否则，它将返回在 Ndis.h 中定义的 NDIS_STATUS_Xxx 错误代码。

注解

可扩展交换机扩展调用 DereferenceSwitchNic 来递减连接到可扩展交换机端口的网络适配器的引用计数器。 虽然可扩展交换机引用计数器具有非零值，但可扩展交换机的协议边缘不会发出对象标识符 (OID) OID_SWITCH_NIC_DELETE 的一组请求来删除与适配器的连接。

如果扩展以前为网络适配器连接调用过 ReferenceSwitchNic，则必须调用 DereferenceSwitchNic。

要求

要求 值
最低受支持的客户端 在 NDIS 6.30 及更高版本中受支持。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
IRQL <= DISPATCH_LEVEL

另请参阅

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic