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 |
另请参阅