Função NdisFSendNetBufferListsComplete (ndis.h)

Artigo
02/26/2024

Os drivers de filtro chamam a função NdisFSendNetBufferListsComplete para retornar uma lista vinculada de estruturas de NET_BUFFER_LIST para 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 Dispatch IRQL Tracking.

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 originaram-se da mesma porta de origem do comutador extensível do Hyper-V.

Para obter mais informações, consulte Sinalizadores de envio e recebimento de comutador extensível do Hyper-V.

Nota Se cada pacote na lista vinculada de estruturas 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.

Nota Esse sinalizador está disponível no NDIS 6.30 e posterior.

Retornar valor

Nenhum

Comentários

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 de todos os recursos associados às estruturas NET_BUFFER_LIST.

O driver de filtro pode concluir o envio de solicitações em qualquer ordem. Por exemplo, o driver de filtro pode concatenar as listas de estrutura 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 .

Nota Um driver de filtro deve acompanhar as solicitações de envio originadas e verificar se ele não chama o A função NdisFSendNetBufferListsComplete quando essas solicitações são concluídas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	Irql_Filter_Driver_Function(ndis)