Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A função FreeNetBufferListForwardingContext libera recursos no contexto de encaminhamento extensível de comutador fora de banda (OOB) de uma estrutura NET_BUFFER_LIST. Esses dados foram usados para operações de envio ou recebimento em um comutador extensível Hyper-V e foram alocados anteriormente chamando a função AllocateNetBufferListForwardingContext.
Sintaxe
NDIS_SWITCH_FREE_NET_BUFFER_LIST_FORWARDING_CONTEXT NdisSwitchFreeNetBufferListForwardingContext;
void NdisSwitchFreeNetBufferListForwardingContext(
[in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
[in, out] PNET_BUFFER_LIST NetBufferList
)
{...}
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.
[in, out] 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 que foi alocado anteriormente chamando a função AllocateNetBufferListForwardingContext.
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 pode originar operações de envio de pacote no caminho de dados de comutador extensível. Por exemplo, a extensão pode enviar pacotes para qualquer porta no comutador extensível. Para obter mais informações sobre esse caminho de dados, consulte Hyper-Vde Caminho de Dados do Comutador Extensível.
Se a extensão de comutador extensível originar uma operação de envio de pacotes, a extensão deverá chamar a função AllocateNetBufferListForwardingContext. Essa função aloca e inicializa o contexto de encaminhamento para a estrutura de NET_BUFFER_LIST especificada. Para obter mais informações sobre esse contexto, consulte Hyper-V contexto de encaminhamento extensível de comutador.
Quando a operação de envio for concluída, a extensão deverá chamar a função FreeNetBufferListForwardingContext para desalocar o contexto de encaminhamento.
Observação A extensão deve chamar a função FreeNetBufferListForwardingContext quando a operação de envio for concluída. A extensão deve fazer isso independentemente de adicionar a estrutura de NET_BUFFER_LIST do pacote a uma lista lookaside ou chamadas NdisFreeNetBufferList para retornar a estrutura a um pool.
Observação Se o parâmetro NetBufferList contiver um ponteiro para uma lista vinculada de várias estruturas de NET_BUFFER_LIST, apenas a primeira estrutura NET_BUFFER_LIST da lista terá seu contexto de encaminhamento desalocado.
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 |
Consulte também
AllocateNetBufferListForwardingContext