NDIS_SWITCH_DEREFERENCE_SWITCH_PORT回调函数 (ndis.h)

  • 项目

DereferenceSwitchPort 函数递减可扩展交换机端口的 Hyper-V 可扩展交换机引用计数器。 引用计数器通过上一次对 ReferenceSwitchPort 的调用递增。

语法

NDIS_SWITCH_DEREFERENCE_SWITCH_PORT NdisSwitchDereferenceSwitchPort;

NDIS_STATUS NdisSwitchDereferenceSwitchPort(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId
)
{...}

参数

[in] NdisSwitchContext

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

[in] SwitchPortId

一个 NDIS_SWITCH_PORT_ID 值，该值包含可扩展交换机引用计数器递增的可扩展交换机端口的唯一标识符。

返回值

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

注解

可扩展交换机扩展调用 DereferenceSwitchPort 来递减可扩展交换机端口的引用计数器。 虽然可扩展交换机引用计数器具有非零值，但可扩展交换机的协议边缘不会发出对象标识符 (OID) 设置 OID_SWITCH_PORT_DELETE 请求来删除端口。

如果扩展以前为可扩展交换机端口调用过 ReferenceSwitchPort，则必须调用 DereferenceSwitchPort。

要求

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

另请参阅

NdisFGetOptionalSwitchHandlers

OID_SWITCH_PORT_DELETE

ReferenceSwitchPort