Funzione NdisFSendNetBufferListsComplete (ndis.h)

Articolo
02/07/2025

I driver di filtro chiamano la funzione NdisFSendNetBufferListsComplete per restituire un elenco collegato di strutture NET_BUFFER_LIST a un driver eccessivamente esistente e restituire lo stato finale di una richiesta di invio.

Sintassi

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

Parametri

[in] NdisFilterHandle

Handle NDIS che identifica questo modulo di filtro. NDIS ha passato l'handle al driver di filtro in una chiamata alla funzione filterAttach FilterAttach.

NetBufferList

Puntatore a un elenco collegato di strutture NET_BUFFER_LIST. Il driver di filtro ha ricevuto le strutture di NET_BUFFER_LIST nelle chiamate precedenti al funzione filterSendNetBufferLists.

[in] SendCompleteFlags

Flag NDIS che possono essere combinati con un'operazione OR. Per cancellare tutti i flag, impostare questo membro su zero. Questa funzione supporta i flag seguenti:

NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL

Specifica che il runtime di integrazione corrente è DISPATCH_LEVEL. Per altre informazioni su questo flag, vedere Dispatch IRQL Tracking.

NDIS_SEND_COMPLETE_FLAGS_SWITCH_SINGLE_SOURCE

Se questo flag è impostato, tutti i pacchetti in un elenco collegato di strutture NET_BUFFER_LIST provengono dalla stessa porta di origine del commutatore estendibile Hyper-V.

Per altre informazioni, vedere Hyper-V flag di invio e ricezione del commutatore estendibile.

Nota Se ogni pacchetto nell'elenco collegato delle strutture di NET_BUFFER_LIST utilizza la stessa porta di origine, l'estensione deve impostare il flag di NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCEnel parametro sendFlags parametro di NdisFSendNetBufferLists quando invia la richiesta.

Nota Questo flag è disponibile in NDIS 6.30 e versioni successive.

Valore restituito

Nessuno

Osservazioni

Un driver di filtro chiama la funzione NdisFSendNetBufferListsComplete per completare le richieste inviate da NDIS al driver funzione filterSendNetBufferLists. Il driver di filtro 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 di filtro mantiene la proprietà delle strutture di NET_BUFFER_LIST e di tutte le risorse associate alle strutture NET_BUFFER_LIST.

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

Nota Un driver di filtro deve tenere traccia delle richieste di invio che ha origine e assicurarsi che non chiami il NdisFSendNetBufferListsComplete funzione al termine di tali richieste.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
piattaforma di destinazione	Desktop
intestazione	ndis.h (include Ndis.h)
libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
regole di conformità DDI	Irql_Filter_Driver_Function(ndis)