NdisAdvanceNetBufferListDataStart-Funktion (ndis/nblapi.h)
Rufen Sie die NdisAdvanceNetBufferListDataStart-Funktion auf, um den Datenbereich freizugeben, der bei vorherigen Aufrufen des NdisRetreatNetBufferListDataStart-Funktion .
Syntax
NDIS_EXPORTED_ROUTINE VOID NdisAdvanceNetBufferListDataStart(
[in] NET_BUFFER_LIST *NetBufferList,
[in] ULONG DataOffsetDelta,
[in] BOOLEAN FreeMdl,
NET_BUFFER_FREE_MDL *FreeMdlMdlHandler
);
Parameter
[in] NetBufferList
Ein Zeiger auf eine zuvor zugeordnete NET_BUFFER_LIST Struktur.
[in] DataOffsetDelta
Die Menge des zu freigebenden Datenspeichers .
[in] FreeMdl
Wenn TRUE und NDIS Arbeitsspeicher zugewiesen haben, um den entsprechenden NdisRetreatNetBufferListDataStart-Aufruf zu erfüllen, gibt diese Funktion den zugeordneten Arbeitsspeicher und die zugeordnete MDL frei.
FreeMdlMdlHandler
Ein optionaler Einstiegspunkt für eine NetFreeMdl-Funktion . Wenn der Aufrufer einen Einstiegspunkt für die NetFreeMdl-Funktion angibt, ruft NDIS NetFreeMdl auf, um eine MDL und Arbeitsspeicher freizugeben.
Rückgabewert
Keine
Bemerkungen
NdisAdvanceNetBufferListDataStart-Releasesverwendet Datenraum für alle NET_BUFFER-Strukturen in einer NET_BUFFER_LIST-Struktur . Wenn FreeMdltrue ist und NdisRetreatNetBufferListDataStart zugewiesener Arbeitsspeicher, um die entsprechende Zuordnungsanforderung zu erfüllen,
NdisAdvanceNetBufferListDataStart gibt den zugewiesenen Arbeitsspeicher frei. Das Aufrufen dieser Funktion entspricht dem Aufrufen NdisAdvanceNetBufferDataStart für jede NET_BUFFER-Struktur auf der NET_BUFFER_LIST-Struktur.
Das Aufrufen von NdisAdvanceNetBufferListDataStart ist jedoch effizienter.
Wenn Protokolltreiber NdisAdvanceNetBufferListDataStart im Empfangspfad aufrufen, um auf die verschiedenen Transportheader zuzugreifen, sollte die MDL-Kette nicht geändert werden, und FreeMdl ist FALSE.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.0 und höher. |
| Zielplattform | Universell |
| Header | ndis/nblapi.h (einschließlich ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_NetBuffer_Function(ndis) |