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

Статья
02/29/2024

Функция 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 (включая Ndis.h)
IRQL	<= DISPATCH_LEVEL