Funzione NdisMCoSendNetBufferListsComplete (ndis.h)

  • Articolo

La funzione NdisMCoSendNetBufferListsComplete restituisce un elenco collegato di strutture NET_BUFFER_LIST a un driver overlying e restituisce lo stato finale di una richiesta di invio CoNDIS.

Sintassi

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

Parametri

[in] NdisVcHandle

Handle che identifica una connessione virtuale (VC). Il driver miniport ha ottenuto questo handle come parametro di input per la funzione MiniportCoCreateVc , quando un client configura una chiamata in uscita o quando il gestore chiamate ha creato un VC per un punto di accesso al servizio registrato client (SAP) per indicare una notifica di chiamata in ingresso.

[in] NetBufferLists

Puntatore a un elenco collegato di strutture NET_BUFFER_LIST . Il conducente miniport ha ricevuto le strutture di NET_BUFFER_LIST nelle chiamate precedenti alla sua Funzione MiniportCoSendNetBufferLists .

[in] SendCompleteFlags

Flag NDIS che possono essere combinati con un'operazione OR bit per bit. Per cancellare tutti i flag, impostare questo parametro su zero. NdisMCoSendNetBufferListsComplete supporta il flag NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL, che; se impostato, indica che l'oggetto IRQL corrente è DISPATCH_LEVEL. Per altre informazioni su questo flag, vedere Dispatch IRQL Tracking.

Valore restituito

nessuno

Osservazioni

Un driver miniport chiama NdisMCoSendNetBufferListsComplete per completare le richieste di invio effettuate da NDIS al driver Funzione MiniportCoSendNetBufferLists . Il driver miniport specifica un elenco collegato di strutture NET_BUFFER_LIST associate alle richieste di invio completate.

Mentre lo stato delle richieste di invio è in sospeso, il driver miniport mantiene la proprietà delle strutture NET_BUFFER_LIST e tutte le risorse associate alle strutture NET_BUFFER_LIST.

Dopo che un driver miniport chiama NdisMCoSendNetBufferListsComplete, NDIS restituisce le strutture NET_BUFFER_LIST e i dati associati al driver overlying che ha generato la richiesta di invio.

Il driver miniport può completare le richieste in qualsiasi ordine. Ad esempio, il driver miniport può concatenare gli elenchi di strutture NET_BUFFER_LIST da più chiamate MiniportCoSendNetBufferLists o suddividere un elenco da una chiamata MiniportCoSendNetBufferLists . Tuttavia, il driver miniport non deve modificare l'elenco di strutture NET_BUFFER associate a una struttura NET_BUFFER_LIST.

Il driver miniport deve impostare uno dei codici di stato seguenti nel membro Stato di ogni struttura NET_BUFFER_LIST che il parametro NetBufferLists specifica:

La chiamata di un driver miniport a NdisMCoSendNetBufferListsComplete non indica necessariamente che i dati per una richiesta di invio sono stati trasmessi sulla rete. Ad esempio, i dati potrebbero essere accodati nell'hardware della scheda di interfaccia di rete.

Requisiti

Requisito Valore
Client minimo supportato Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione Desktop
Intestazione ndis.h (includere Ndis.h)
Libreria Ndis.lib
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI Irql_MCO_Function(ndis)

Vedi anche

MiniportCancelSend

MiniportCoCreateVc

MiniportCoSendNetBufferLists

NET_BUFFER

NET_BUFFER_LIST