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 的對象標識元集要求，以刪除與配接器的連線。
如果先前針對網路適配器連線呼叫 ReferenceSwitchNic，此擴充功能必須呼叫 DereferenceSwitchNic。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.30 和更新版本支援。 |
| 目標平臺 | 桌面 |
| 標頭 | ndis.h （包括 Ndis.h） |
| IRQL | <= DISPATCH_LEVEL |
另請參閱