Função NdisMCoSendNetBufferListsComplete (ndis.h)
A função NdisMCoSendNetBufferListsComplete retorna uma lista vinculada de estruturas de NET_BUFFER_LIST a um driver sobreposto e retorna o 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 miniporto recebeu as estruturas de NET_BUFFER_LIST em chamadas anteriores para sua 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 de Acompanhamento de IRQL de Expedição.
Valor de retorno
Nenhum
Observações
Um driver de miniporto chama NdisMCoSendNetBufferListsComplete para concluir as solicitações de envio feitas pelo NDIS ao 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 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 miniporto pode concluir as solicitações de envio em qualquer ordem. Por exemplo, o driver de miniporto pode concatenar as listas de estrutura de NET_BUFFER_LIST de vários MiniportCoSendNetBufferLists chamadas 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 miniporto deve definir um dos seguintes códigos de status no Status membro de cada estrutura NET_BUFFER_LIST que o parâmetro NetBufferLists especifica:
Uma chamada de driver de miniport 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.