NDIS_SWITCH_GROW_NET_BUFFER_LIST_DESTINATIONS função de retorno de chamada (ndis.h)

Artigo
02/07/2025

A função GrowNetBufferListDestinations adiciona espaço para portas de destino de comutador extensíveis Hyper-V adicionais a um pacote especificado por uma estrutura de NET_BUFFER_LIST.

Sintaxe

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
)
{...}

Parâmetros

[in] NdisSwitchContext

Um valor NDIS_SWITCH_CONTEXT que contém o identificador do módulo de comutador extensível ao qual a extensão do comutador extensível Hyper-V está anexada. Quando a extensão chama NdisFGetOptionalSwitchHandlers, esse identificador é retornado por meio do parâmetro NdisSwitchContext.

NetBufferList

Um ponteiro para uma lista vinculada de estruturas de NET_BUFFER_LIST.

Observação Essa estrutura deve conter um contexto extensível de encaminhamento de comutador. Se a extensão criou ou clonou o pacote, ela deve ter alocado essa estrutura anteriormente chamando a função AllocateNetBufferListForwardingContext. Para obter mais informações sobre o contexto extensível de encaminhamento de comutador, consulte Hyper-Vde contexto de encaminhamento extensível de comutador .

[in] NumberOfNewDestinations

Um valor UINT32 que especifica o número de novas portas de destino a serem adicionadas para o pacote.

[out] Destinations

Um ponteiro para uma estrutura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY. Essa estrutura especifica as portas de destino de comutador extensível do pacote.

Valor de retorno

Se a chamada for bem-sucedida, a função retornará NDIS_STATUS_SUCCESS. Caso contrário, ele retornará um código de erro NDIS_STATUS_Xxx definido em Ndis.h.

Observações

A extensão de comutador extensível chama a função GrowNetBufferListDestinations para adicionar espaço para portas de destino para um pacote. Os destinos de porta são especificados por meio de uma estrutura NDIS_SWITCH_FORWARDING_DESTINATION_ARRAY.

Para obter mais informações sobre como adicionar portas de destino a um pacote, consulte Adicionando dados extensíveis de porta de destino de comutador extensível a um pacote.

Observação Se o parâmetro NetBufferList contiver um ponteiro para uma lista vinculada de várias estruturas de NET_BUFFER_LIST, o espaço para portas de destino adicionais só será adicionado à primeira estrutura NET_BUFFER_LIST da lista.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no NDIS 6.30 e posterior.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
IRQL	<= DISPATCH_LEVEL