NDIS_SWITCH_SET_NET_BUFFER_LIST_SOURCE回调函数 (ndis.h)

项目
08/07/2023

SetNetBufferListSource 函数为NET_BUFFER_LIST结构指定的数据包设置 Hyper-V 可扩展交换机源端口标识符和网络适配器索引。

语法

NDIS_SWITCH_SET_NET_BUFFER_LIST_SOURCE NdisSwitchSetNetBufferListSource;

NDIS_STATUS NdisSwitchSetNetBufferListSource(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
       PNET_BUFFER_LIST NetBufferList,
  [in] NDIS_SWITCH_PORT_ID PortId,
  [in] NDIS_SWITCH_NIC_INDEX NicIndex
)
{...}

参数

[in] NdisSwitchContext

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

NetBufferList

指向单个数据包 NET_BUFFER_LIST 结构的指针。

注意此结构必须包含以前通过调用 AllocateNetBufferListForwardingContext 函数分配的可扩展交换机转发上下文。有关可扩展交换机转发上下文的详细信息，请参阅 Hyper-V 可扩展交换机转发上下文。

[in] PortId

一个NDIS_SWITCH_PORT_ID值，该值指定可扩展交换机上源端口的唯一标识符。

[in] NicIndex

一个 NDIS_SWITCH_NIC_INDEX 值，该值指定连接到 PortId 参数指定的可扩展交换机端口的网络适配器的索引。

有关NDIS_SWITCH_NIC_INDEX值的详细信息，请参阅网络适配器索引值。

注意此参数必须指定处于连接状态的网络适配器的索引值。无法指定处于创建或断开连接状态的网络适配器的索引值。有关网络连接状态的详细信息，请参阅 Hyper-V 可扩展交换机端口和网络适配器状态。

返回值

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

注解

可扩展交换机扩展调用 SetNetBufferListSource 函数，以在数据包的NET_BUFFER_LIST 结构中设置源端口标识符和网络适配器索引。扩展针对以下类型的数据包执行此操作：

扩展已为发送或接收操作分配的新数据包。
注意在扩展为分配的数据包调用 SetNetBufferListSource 之前，它必须调用 AllocateNetBufferListForwardingContext。
扩展从它正在筛选的原始数据包克隆的重复数据包。该扩展通过调用 NdisAllocateCloneNetBufferList 复制数据包。

在这两种情况下，新的或重复的数据包的源端口标识符设置为 NDIS_SWITCH_DEFAULT_PORT_ID ，其源网络适配器索引设置为 NDIS_SWITCH_DEFAULT_NIC_INDEX。该扩展调用 SetNetBufferListSource 函数来更改数据包 NET_BUFFER_LIST 结构中的源端口标识符和网络适配器索引。

例如，源端口标识符为 NDIS_SWITCH_DEFAULT_PORT_ID 的数据包受信任，并绕过许多可扩展的交换机端口策略。这些策略包括访问控制列表 (ACL) 和服务质量 (QoS) 。如果扩展为数据包指定非默认源端口，则允许将该端口的策略应用于数据包。

注意由于源端口标识符 为 NDIS_SWITCH_DEFAULT_PORT_ID 的数据包受信任，因此扩展在产生数据包流量时必须非常小心地使用此源端口标识符。有关建议使用 源端口NDIS_SWITCH_DEFAULT_PORT_ID 的详细信息，请参阅管理 Hyper-V 可扩展交换机源端口数据。

有关数据包发送和接收操作的详细信息，请参阅筛选模块发送和接收操作。