Fungsi NdisAdvanceNetBufferListDataStart (ndis/nblapi.h)

Artikel
08/07/2023

Panggil fungsi NdisAdvanceNetBufferListDataStart untuk merilis ruang data yang diklaim dalam panggilan sebelumnya ke Fungsi NdisRetreatNetBufferListDataStart .

Sintaks

NDIS_EXPORTED_ROUTINE VOID NdisAdvanceNetBufferListDataStart(
  [in] NET_BUFFER_LIST     *NetBufferList,
  [in] ULONG               DataOffsetDelta,
  [in] BOOLEAN             FreeMdl,
       NET_BUFFER_FREE_MDL *FreeMdlMdlHandler
);

Parameter

[in] NetBufferList

Penunjuk ke struktur NET_BUFFER_LIST yang dialokasikan sebelumnya.

[in] DataOffsetDelta

Jumlah ruang data yang digunakan untuk dilepaskan.

[in] FreeMdl

Jika true dan NDIS mengalokasikan memori untuk memenuhi panggilan NdisRetreatNetBufferListDataStart yang sesuai, fungsi ini membebaskan memori yang dialokasikan dan MDL terkait.

FreeMdlMdlHandler

Titik masuk opsional untuk fungsi NetFreeMdl . Jika pemanggil menentukan titik masuk untuk fungsi NetFreeMdl , NDIS memanggil NetFreeMdl untuk membebaskan MDL dan memori.

Nilai kembali

Tidak ada

Keterangan

Rilis NdisAdvanceNetBufferListDataStartmenggunakan ruang data untuk semua struktur NET_BUFFER dalam struktur NET_BUFFER_LIST . Jika FreeMdlTRUE dan NdisRetreatNetBufferListDataStart mengalokasikan memori untuk memenuhi permintaan alokasi yang sesuai,
NdisAdvanceNetBufferListDataStart membebaskan memori yang dialokasikan. Memanggil fungsi ini setara dengan panggilan NdisAdvanceNetBufferDataStart untuk setiap struktur NET_BUFFER pada struktur NET_BUFFER_LIST. Namun, memanggil NdisAdvanceNetBufferListDataStart lebih efisien.

Ketika driver protokol memanggil NdisAdvanceNetBufferListDataStart pada jalur terima untuk mengakses berbagai header transportasi, rantai MDL tidak boleh dimodifikasi dan FreeMdlFALSE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Universal
Header	ndis/nblapi.h (sertakan ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_NetBuffer_Function(ndis)