NDIS_SWITCH_ADD_NET_BUFFER_LIST_DESTINATION回呼函式（ndis.h）

發行項
02/07/2025

AddNetBufferListDestination 函式會為 NET_BUFFER_LIST 結構指定的封包新增單一目的地埠。

語法

NDIS_SWITCH_ADD_NET_BUFFER_LIST_DESTINATION NdisSwitchAddNetBufferListDestination;

NDIS_STATUS NdisSwitchAddNetBufferListDestination(
  [in]      NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in, out] PNET_BUFFER_LIST NetBufferList,
  [in]      PNDIS_SWITCH_PORT_DESTINATION Destination
)
{...}

參數

[in] NdisSwitchContext

NDIS_SWITCH_CONTEXT值，其中包含附加 Hyper-V 可延伸交換器擴充功能的可延伸交換器模組句柄。當擴充功能呼叫 NdisFGetOptionalSwitchHandlers時，此句柄會透過 NdisSwitchContext 參數傳回。

[in, out] NetBufferList

封包 NET_BUFFER_LIST 結構的指標。

附註此結構必須包含可延伸的交換器轉送內容。如果已建立或複製封包的延伸模組，則先前必須呼叫 AllocateNetBufferListForwardingContext 函式來配置此結構。

[in] Destination

NDIS_SWITCH_PORT_DESTINATION 結構的指標。此結構會指定封包將轉送至的目的地可延伸交換器埠。

傳回值

如果呼叫成功，函式會傳回NDIS_STATUS_SUCCESS。否則，它會傳回在 Ndis.h 中定義的NDIS_STATUS_Xxx 錯誤碼。

言論

轉送可延伸交換器擴充功能會呼叫 AddNetBufferListDestination，以定義封包的單一可延伸交換器目的地埠。延伸模組會藉由初始化 NDIS_SWITCH_PORT_DESTINATION 結構來指定此埠。延伸模組會將 Destination 參數設定為此結構的指標。如需如何指定可延伸交換器目的地埠的詳細資訊，請參閱管理 Hyper-V 可延伸交換器目的地埠資料。

注意基於效能考慮，擴充功能不應該呼叫具有多個目的地埠的 AddNetBufferListDestination 封包。

擴充功能必須先遵循下列指導方針，才能呼叫 addNetBufferListDestination：

只有轉送延伸模組可以呼叫 AddNetBufferListDestination，以新增封包的目的地埠。如需此擴充功能類型的詳細資訊，請參閱轉送延伸模組。
如果轉送延伸模組源自具有一個目的地埠的封包，擴充功能必須先呼叫 AllocateNetBufferListForwardingContext 函式。此函式會配置封包的可延伸交換器轉送內容。此數據包含封包頻外（OOB）資訊內的可延伸交換器來源和目的地埠。
如需此內容的詳細資訊，請參閱 Hyper-V 可延伸交換器轉送內容。
延伸模組修改 NDIS_SWITCH_PORT_DESTINATION 結構中的目的地埠信息之後，它會呼叫 AddNetBufferListDestination，以認可封包 NET_BUFFER_LIST 結構的變更。
注意基於效能考慮，擴充功能不應該呼叫 UpdateNetBufferListDestinations 函式來認可封包的變更。