Funzione NdisMCoIndicateReceiveNetBufferLists (ndis.h)

Articolo
02/29/2024

La funzione NdisMCoIndicateReceiveNetBufferLists indica che il driver miniport ha ricevuto dati dalla rete.

Sintassi

void NdisMCoIndicateReceiveNetBufferLists(
  [in] IN NDIS_HANDLE      NdisVcHandle,
  [in] IN PNET_BUFFER_LIST NetBufferLists,
  [in] IN ULONG            NumberOfNetBufferLists,
  [in] IN ULONG            CoReceiveFlags
);

Parametri

[in] NdisVcHandle

Handle che identifica una connessione virtuale (VC). Il driver miniport ha ottenuto questo handle come parametro di input per la relativa funzione MiniportCoCreateVc , sia 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 dal client (SAP) per indicare una notifica di chiamata in ingresso su .

[in] NetBufferLists

Elenco collegato di strutture NET_BUFFER_LIST allocate dal driver miniport.

[in] NumberOfNetBufferLists

Numero di strutture NET_BUFFER_LIST presenti nell'elenco collegato di strutture specificate da NetBufferLists .

[in] CoReceiveFlags

Flag che definiscono gli attributi per l'operazione di invio. I flag possono essere combinati con un'operazione OR bit per bit. Per cancellare tutti i flag, impostare questo parametro su zero. NdisMCoIndicateReceiveNetBufferLists supporta i flag seguenti:

NDIS_RECEIVE_FLAGS_DISPATCH_LEVEL

Il runtime di integrazione corrente è DISPATCH_LEVEL. Per altre informazioni su questo flag, vedere Dispatch IRQL Tracking.For more information about this flag, see Dispatch IRQL Tracking.

NDIS_RECEIVE_FLAGS_RESOURCES

Il driver miniport recupera la proprietà delle strutture NET_BUFFER_LIST ed eventuali strutture NET_BUFFER collegate immediatamente dopo la restituzione di NdisMCoIndicateReceiveNetBufferLists .

Valore restituito

nessuno

Osservazioni

Un driver miniport chiama in genere la funzione NdisMCoIndicateReceiveNetBufferLists dalla funzione MiniportInterruptDPC . Quando un driver miniport chiama NdisMCoIndicateReceiveNetBufferLists, specifica un elenco di strutture NET_BUFFER_LIST nel parametro NetBufferLists . NDIS passa quindi le strutture NET_BUFFER_LIST ai driver di protocollo associati.

I driver Miniport devono impostare il membro SourceHandle di ogni struttura NET_BUFFER_LIST sullo stesso valore del parametro NdisVcHandle in modo che NDIS possa restituire le strutture NET_BUFFER_LIST al driver miniport corretto.

Se un driver miniport chiama NdisMCoIndicateReceiveNetBufferLists e cancella il flag NDIS_RECEIVE_FLAGS_RESOURCES nel parametro CoReceiveFlags , NDIS restituisce le strutture NET_BUFFER_LIST specificate da NetBufferLists al driver miniport Funzione MiniportReturnNetBufferLists . In questo caso, il driver miniport non deve recuperare le strutture NET_BUFFER_LIST finché NDIS non restituisce le strutture NET_BUFFER_LIST alla funzione MiniportReturnNetBufferLists del driver miniport .

Se un driver miniport chiama NdisMCoIndicateReceiveNetBufferLists e imposta immediatamente il flag NDIS_RECEIVE_FLAGS_RESOURCES nel parametro CoReceiveFlags , il driver miniport deve ottenere immediatamente la proprietà delle strutture NET_BUFFER_LIST. In questo caso, NDIS non chiama la funzione MiniportReturnNetBufferLists del driver miniport per restituire le strutture NET_BUFFER_LIST. Al contrario, NDIS restituisce le strutture NET_BUFFER_LIST al driver miniport quando restituisce NdisMCoIndicateReceiveNetBufferLists . Il driver miniport deve recuperare le strutture NET_BUFFER_LIST immediatamente dopo la restituzione di NdisMCoIndicateReceiveNetBufferLists . Per recuperare le strutture NET_BUFFER_LIST, un conducente miniport può chiamare il proprio Funzione MiniportReturnNetBufferLists .

Se un driver miniport imposta il flag NDIS_RECEIVE_FLAGS_RESOURCES nel parametro CoReceiveFlags , i driver di protocollo devono copiare i dati di rete e rilasciare le strutture NET_BUFFER_LIST nel driver miniport. È consigliabile progettare i driver miniport con strutture preallocate NET_BUFFER_LIST sufficienti per evitare la copia non necessaria.

Il chiamante di NdisMCoIndicateReceiveNetBufferLists deve inizializzare correttamente le strutture di NET_BUFFER_LIST, le strutture associate NET_BUFFER e gli elenchi dei descrittori di memoria associati.The caller of NdisMCoIndicateReceiveNetBufferLists must initialize the NET_BUFFER_LIST structures, the attached NET_BUFFER structures, and any attached memory descriptor lists (MDLs).

Requisiti

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