NdisMCoSendNetBufferListsComplete-Funktion (ndis.h)
Die NdisMCoSendNetBufferListsComplete--Funktion gibt eine verknüpfte Liste von NET_BUFFER_LIST Strukturen an einen Überlyingtreiber zurück und gibt den endgültigen Status einer CoNDIS-Sendeanforderung zurück.
Syntax
void NdisMCoSendNetBufferListsComplete(
[in] IN NDIS_HANDLE NdisVcHandle,
[in] IN PNET_BUFFER_LIST NetBufferLists,
[in] IN ULONG SendCompleteFlags
);
Parameter
[in] NdisVcHandle
Ein Handle, das eine virtuelle Verbindung (VC) identifiziert. Der Miniporttreiber hat dieses Handle als Eingabeparameter für seine MiniportCoCreateVc--Funktion erhalten, entweder wenn ein Client einen ausgehenden Anruf einrichtet oder wenn der Anrufmanager eine VC für einen client registrierten Dienstzugriffspunkt (SAP) erstellt hat, um eine eingehende Anrufbenachrichtigung anzuzeigen.
[in] NetBufferLists
Ein Zeiger auf eine verknüpfte Liste von NET_BUFFER_LIST Strukturen. Der Miniporttreiber erhielt die NET_BUFFER_LIST Strukturen in früheren Aufrufen an seine MiniportCoSendNetBufferLists Funktion.
[in] SendCompleteFlags
NDIS-Flags, die mit einem bitweisen OR-Vorgang kombiniert werden können. Um alle Flags zu löschen, legen Sie diesen Parameter auf Null fest. NdisMCoSendNetBufferListsComplete unterstützt das NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL Flag, das; wenn festgelegt, gibt an, dass die aktuelle IRQL DISPATCH_LEVEL ist. Weitere Informationen zu diesem Kennzeichen finden Sie unter IRQL Tracking.
Rückgabewert
Nichts
Bemerkungen
Ein Miniporttreiber ruft NdisMCoSendNetBufferListsComplete- auf, um Anforderungen zu senden, die NDIS an den Treiber gesendet hat MiniportCoSendNetBufferLists Funktion. Der Miniporttreiber gibt eine verknüpfte Liste der NET_BUFFER_LIST Strukturen an, die den abgeschlossenen Sendeanforderungen zugeordnet sind.
Während der Status der Sendeanforderungen aussteht, behält der Miniporttreiber den Besitz der NET_BUFFER_LIST Strukturen und aller Ressourcen, die den NET_BUFFER_LIST Strukturen zugeordnet sind.
Nachdem ein Miniporttreiber NdisMCoSendNetBufferListsComplete-aufgerufen hat, gibt NDIS die NET_BUFFER_LIST Strukturen und zugeordneten Daten an den Überleitungstreiber zurück, der die Sendeanforderung stammte.
Der Miniporttreiber kann Sendeanforderungen in beliebiger Reihenfolge abschließen. Beispielsweise könnte der Miniporttreiber die NET_BUFFER_LIST Strukturlisten aus mehreren MiniportCoSendNetBufferLists Aufrufen verketten oder eine Liste aus einem MiniportCoSendNetBufferLists Aufruf aufteilen. Der Miniporttreiber darf jedoch nicht die Liste der NET_BUFFER Strukturen ändern, die einer NET_BUFFER_LIST Struktur zugeordnet sind.
Der Miniporttreiber muss einen der folgenden Statuscodes im Status Member jeder NET_BUFFER_LIST Struktur festlegen, die der NetBufferLists-parameter angibt:
Der Aufruf eines Miniporttreibers an NdisMCoSendNetBufferListsComplete weist nicht unbedingt darauf hin, dass die Daten für eine Sendeanforderung über das Netzwerk übertragen wurden. Beispielsweise können die Daten in der NIC-Hardware in die Warteschlange gestellt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCO_Function(ndis) |