Поделиться через


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

Функция 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

См. также раздел

AllocateNetBufferListForwardingContext

NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY

NDIS_SWITCH_PORT_DESTINATION

NET_BUFFER

NET_BUFFER_LIST

NdisFGetOptionalSwitchHandlers

UpdateNetBufferListDestinations