NdisAdvanceNetBufferListDataStart-Funktion (ndis/nblapi.h)
Rufen Sie die NdisAdvanceNetBufferListDataStart--Funktion auf, um den Datenbereich freizugeben, der in 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 verwendeten Datenbereichs freigeben.
[in] FreeMdl
Wenn TRUE- und NDIS Speicher zugewiesen hat, um den entsprechenden NdisRetreatNetBufferListDataStart Aufruf zu erfüllen, gibt diese Funktion den zugeordneten Speicher 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 einen Arbeitsspeicher freizugeben.
Rückgabewert
Nichts
Bemerkungen
NdisAdvanceNetBufferListDataStart veröffentlicht verwendeten Datenraum für alle NET_BUFFER Strukturen in einer NET_BUFFER_LIST Struktur. Wenn FreeMdlTRUE und
NdisRetreatNetBufferListDataStart zugeordneten Arbeitsspeicher zur Erfüllung der entsprechenden Zuordnungsanforderung,
NdisAdvanceNetBufferListDataStart den zugeordneten Speicher frei. Das Aufrufen dieser Funktion entspricht dem Aufrufen von
NdisAdvanceNetBufferDataStart für jede NET_BUFFER Struktur der NET_BUFFER_LIST Struktur.
Das Aufrufen NdisAdvanceNetBufferListDataStart ist jedoch effizienter.
Wenn Protokolltreiber NdisAdvanceNetBufferListDataStart auf dem Empfangspfad aufrufen, um auf die verschiedenen Transportheader zuzugreifen, sollte die MDL-Kette nicht geändert werden, und FreeMdlFALSEist.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Unterstützt in NDIS 6.0 und höher. |
Zielplattform- | Universal |
Header- | ndis/nblapi.h (include ndis.h) |
Library | Ndis.lib |
IRQL- | <= DISPATCH_LEVEL |
DDI-Complianceregeln | Irql_NetBuffer_Function(ndis) |