NDIS_SWITCH_DEREFERENCE_SWITCH_NIC回呼函式 (ndis.h)

發行項
02/29/2024

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。