функция обратного вызова NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS (ndis.h)

Статья
02/07/2025

Функция GrowNetBufferListDestinations добавляет пространство для дополнительных Hyper-V расширяемых портов назначения коммутатора в пакет, указанный структурой NET_BUFFER_LIST.

Синтаксис

NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS NdisSwitchGrowNetBufferListDestinations;

NDIS_STATUS NdisSwitchGrowNetBufferListDestinations(
  [in]  NDIS_SWITCH_CONTEXT NdisSwitchContext,
        PNET_BUFFER_LIST NetBufferList,
  [in]  UINT32 NumberOfNewDestinations,
  [out] PNDIS_SWITCH_FORWARDING_DESTINATION_ARRAY *Destinations
)
{...}

Параметры

[in] NdisSwitchContext

Значение NDIS_SWITCH_CONTEXT, содержащее дескриптор расширяемого модуля коммутатора, к которому подключено расширение расширяемого коммутатора Hyper-V. Когда расширение вызывает NdisFGetOptionalSwitchHandlers, этот дескриптор возвращается через параметр NdisSwitchContext.

NetBufferList

Указатель на связанный список структур NET_BUFFER_LIST.

примечание Эта структура должна содержать расширяемый контекст переадресации переадресации. Если расширение создало или клонировало пакет, оно должно ранее выделить эту структуру, вызвав функцию AllocateNetBufferListForwardingContext. Дополнительные сведения о контексте переадресации расширяемого коммутатора см. в разделе Hyper-V Контекст переадресации переадресации коммутаторов.

[in] NumberOfNewDestinations

Значение UINT32, указывающее количество новых портов назначения, добавляемых для пакета.

[out] Destinations

Указатель на структуру NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY. Эта структура задает расширяемые порты назначения коммутатора пакета.

Возвращаемое значение

Если вызов выполнен успешно, функция возвращает NDIS_STATUS_SUCCESS. В противном случае возвращается код ошибки NDIS_STATUS_Xxx, определенный в Ndis.h.

Замечания

Расширение расширяемого коммутатора вызывает функцию GrowNetBufferListDestinations, чтобы добавить пространство для конечных портов для пакета. Назначения портов задаются с помощью структуры NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY.

Дополнительные сведения о добавлении портов назначения в пакет см. в разделе Добавление данных порта назначения расширяемого коммутатора в пакет.

Примечание Если параметр NetBufferList содержит указатель на связанный список нескольких структур NET_BUFFER_LIST, пространство для дополнительных конечных портов добавляется только в первую структуру NET_BUFFER_LIST в списке.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.30 и более поздних версиях.
целевая платформа	Настольный
заголовка	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL