Função NdisFSendNetBufferListsComplete (ndis.h)

Artigo
02/07/2025

Os drivers de filtro chamam a função NdisFSendNetBufferListsComplete para retornar uma lista vinculada de estruturas de NET_BUFFER_LIST a um driver sobreposto e retornar o status final de uma solicitação de envio.

Sintaxe

void NdisFSendNetBufferListsComplete(
  [in] NDIS_HANDLE      NdisFilterHandle,
       PNET_BUFFER_LIST NetBufferList,
  [in] ULONG            SendCompleteFlags
);

Parâmetros

[in] NdisFilterHandle

O identificador NDIS que identifica esse módulo de filtro. O NDIS passou o identificador para o driver de filtro em uma chamada para a função FilterAttach.

NetBufferList

Um ponteiro para uma lista vinculada de estruturas de NET_BUFFER_LIST. O driver de filtro recebeu as estruturas de NET_BUFFER_LIST em chamadas anteriores para o função FilterSendNetBufferLists.

[in] SendCompleteFlags

Sinalizadores NDIS que podem ser combinados com uma operação OR. Para limpar todos os sinalizadores, defina esse membro como zero. Essa função dá suporte aos seguintes sinalizadores:

NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL

Especifica que o IRQL atual está DISPATCH_LEVEL. Para obter mais informações sobre esse sinalizador, consulte de Acompanhamento de IRQL de Expedição.

NDIS_SEND_COMPLETE_FLAGS_SWITCH_SINGLE_SOURCE

Se esse sinalizador for definido, todos os pacotes em uma lista vinculada de estruturas de NET_BUFFER_LIST se originaram da mesma porta de origem do comutador extensível Hyper-V.

Para obter mais informações, consulte Hyper-V Sinalizadores de Envio e Recebimento Extensíveis do Comutador.

Observação Se cada pacote na lista vinculada de estruturas de NET_BUFFER_LIST usar a mesma porta de origem, a extensão deverá definir o sinalizador NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCE no parâmetro SendFlags de NdisFSendNetBufferLists ao enviar a solicitação.

Observação Esse sinalizador está disponível no NDIS 6.30 e posterior.

Valor de retorno

Nenhum

Observações

Um driver de filtro chama a função NdisFSendNetBufferListsComplete para concluir as solicitações de envio feitas pelo NDIS para o driver função FilterSendNetBufferLists. O driver de filtro especifica uma lista vinculada de estruturas de NET_BUFFER_LIST associadas às solicitações de envio concluídas. Embora o status das solicitações de envio esteja pendente, o driver de filtro mantém a propriedade das estruturas de NET_BUFFER_LIST e todos os recursos associados às estruturas de NET_BUFFER_LIST.

O driver de filtro pode concluir as solicitações de envio em qualquer ordem. Por exemplo, o driver de filtro pode concatenar as listas de estrutura de NET_BUFFER_LIST de várias chamadas FilterSendNetBufferLists ou dividir uma lista de uma chamada FilterSendNetBufferLists. No entanto, o driver de filtro não deve modificar a lista de estruturas de NET_BUFFER associadas a uma estrutura NET_BUFFER_LIST.

Observação Um driver de filtro deve acompanhar as solicitações de envio originadas e certificar-se de que ele não chame o função NdisFSendNetBufferListsComplete quando essas solicitações forem concluídas.

Requisitos

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