Fungsi NdisFreeNetBufferList (ndis/nblapi.h)

Artikel
03/10/2023

Panggil fungsi NdisFreeNetBufferList untuk membebaskan struktur NET_BUFFER_LIST yang sebelumnya dialokasikan dari kumpulan struktur NET_BUFFER_LIST.

Sintaks

NDIS_EXPORTED_ROUTINE VOID NdisFreeNetBufferList(
  [in] NET_BUFFER_LIST *NetBufferList
);

Parameter

[in] NetBufferList

Penunjuk ke struktur NET_BUFFER_LIST yang dialokasikan dengan memanggil NdisAllocateNetBufferList atau Fungsi NdisAllocateNetBufferAndNetBufferList .

Nilai kembali

Tidak ada

Keterangan

Untuk mengalokasikan struktur NET_BUFFER_LIST dari kumpulan, panggil NdisAllocateNetBufferList atau Fungsi NdisAllocateNetBufferAndNetBufferList .

Struktur NET_BUFFER yang terkait dengan struktur NET_BUFFER_LIST tidak dibebaskan kecuali telah dialokasikan sebelumnya dengan struktur NET_BUFFER_LIST. Anda dapat menggunakan kembali struktur NET_BUFFER apa pun yang tidak dialokasikan sebelumnya atau Anda harus membebaskan struktur tersebut secara terpisah.

Jika Anda mengalokasikan ruang konteks untuk struktur NET_BUFFER_LIST dengan Fungsi NdisAllocateNetBufferListContext , Anda harus membebaskan ruang konteks tersebut sebelum membebaskan struktur NET_BUFFER_LIST. Anda tidak boleh mencoba membebaskan ruang konteks yang Dialokasikan dengan NdisAllocateNetBufferList atau NdisAllocateNetBufferAndNetBufferList dengan menentukan parameter ContextSize dan ContextBackFill .

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), NdisAllocateNetBufferList(ndis), NdisAllocateNetBufferList_InitFail(ndis), NdisAllocateNetBufferList2(ndis), NdisAllocateNetBufferList2_InitFail(ndis)