Função NdisMCoSendNetBufferListsComplete (ndis.h)

  • Artigo

A função NdisMCoSendNetBufferListsComplete retorna uma lista vinculada de estruturas de NET_BUFFER_LIST para um driver sobreposto e retorna a status final de uma solicitação de envio do CoNDIS.

Sintaxe

void NdisMCoSendNetBufferListsComplete(
  [in] IN NDIS_HANDLE      NdisVcHandle,
  [in] IN PNET_BUFFER_LIST NetBufferLists,
  [in] IN ULONG            SendCompleteFlags
);

Parâmetros

[in] NdisVcHandle

Um identificador que identifica uma VC (conexão virtual). O driver de miniporto obteve esse identificador como um parâmetro de entrada para sua função MiniportCoCreateVc , quando um cliente configurou uma chamada de saída ou quando o gerenciador de chamadas criou uma VC para um SAP (ponto de acesso de serviço registrado pelo cliente) para indicar uma notificação de chamada de entrada.

[in] NetBufferLists

Um ponteiro para uma lista vinculada de estruturas de NET_BUFFER_LIST . O driver de miniporta recebeu as estruturas de NET_BUFFER_LIST em chamadas anteriores para seu Função MiniportCoSendNetBufferLists .

[in] SendCompleteFlags

Sinalizadores NDIS que podem ser combinados com uma operação OR bit a bit. Para limpar todos os sinalizadores, defina esse parâmetro como zero. NdisMCoSendNetBufferListsComplete dá suporte ao sinalizador NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL, que; se definido, indica que o IRQL atual está DISPATCH_LEVEL. Para obter mais informações sobre esse sinalizador, consulte Dispatch IRQL Tracking.

Retornar valor

Nenhum

Comentários

Um driver de miniporto chama NdisMCoSendNetBufferListsComplete para concluir as solicitações de envio feitas pelo NDIS para o driver Função MiniportCoSendNetBufferLists . O driver de miniporto 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 miniporto mantém a propriedade das estruturas de NET_BUFFER_LIST e todos os recursos associados às estruturas de NET_BUFFER_LIST.

Depois que um driver de miniporto chama NdisMCoSendNetBufferListsComplete, o NDIS retorna as estruturas de NET_BUFFER_LIST e os dados associados ao driver sobreposto que originou a solicitação de envio.

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

O driver de miniporta deve definir um dos seguintes códigos de status no membro Status de cada estrutura NET_BUFFER_LIST especificada pelo parâmetro NetBufferLists:

A chamada de um driver de miniporto para NdisMCoSendNetBufferListsComplete não indica necessariamente que os dados de uma solicitação de envio foram transmitidos pela rede. Por exemplo, os dados podem ser enfileirados no hardware nic.

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_MCO_Function(ndis)

Confira também

MiniportCancelSend

MiniportCoCreateVc

MiniportCoSendNetBufferLists

NET_BUFFER

NET_BUFFER_LIST