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_SWITCH_NIC_DELETE 的对象标识符(OID)集请求来删除与适配器的连接。

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

要求

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

另请参阅

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic