Freigeben über


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)

Weitere Informationen

NET_BUFFER

NET_BUFFER_LIST

NdisAdvanceNetBufferDataStart NdisRetreatNetBufferListDataStart

NetAllocateMdl

NetFreeMdl