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

Artigo
02/26/2024

A função GrowNetBufferListDestinations adiciona espaço para portas de destino adicionais do comutador extensível do Hyper-V a um pacote especificado por uma estrutura 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 do 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 .

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

[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 do comutador extensível do pacote.

Retornar valor

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.

Comentários

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 de porta de destino de comutador extensível a um pacote.

Nota 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 na lista.

Requisitos

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