Fungsi NdisFreeMemoryWithTagPriority (ndis.h)

Artikel
08/07/2023

Fungsi NdisFreeMemoryWithTagPriority merilis memori yang dialokasikan dengan Fungsi NdisAllocateMemoryWithTagPriority .

Sintaks

void NdisFreeMemoryWithTagPriority(
  [in] NDIS_HANDLE NdisHandle,
  [in] PVOID       VirtualAddress,
  [in] ULONG       Tag
);

Parameter

[in] NdisHandle

Driver NDIS atau handel instans yang diperoleh selama inisialisasi penelepon. Ini harus menjadi pegangan yang sama dengan yang diteruskan driver ke Fungsi NdisAllocateMemoryWithTagPriority . Misalnya, driver miniport dapat menggunakan handel NDIS yang diperoleh dari Fungsi NdisMRegisterMiniportDriver atau MiniportInitializeEx . Driver NDIS lainnya dapat menggunakan handel dari fungsi berikut:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] VirtualAddress

Penunjuk ke alamat virtual dasar memori yang dialokasikan. Alamat ini dikembalikan oleh Fungsi NdisAllocateMemoryWithTagPriority .

[in] Tag

String, dibatasi oleh tanda kutip tunggal, dengan hingga empat karakter, biasanya ditentukan dalam urutan terbalik. Tag default yang disediakan NDIS untuk panggilan ini adalah 'maDN', tetapi pemanggil dapat mengambil alih default ini dengan menyediakan nilai eksplisit.

Mengembalikan nilai

Tidak ada

Keterangan

Karena memori non-cache dan memori yang berdekatan jarang dirilis sampai driver miniport yang mengalokasikan dibongkar, pemanggil NdisFreeMemoryWithTagPriority biasanya berjalan di IRQL = PASSIVE_LEVEL untuk jenis de-alokasi ini. Dalam hal apa pun:

Ketika penelepon NdisFreeMemoryWithTagPriority merilis memori yang berdampingan, itu harus berjalan di IRQL = PASSIVE_LEVEL.
Ketika penelepon NdisFreeMemoryWithTagPriority merilis memori non-cache, itu harus berjalan di IRQL < DISPATCH_LEVEL.
Ketika penelepon NdisFreeMemoryWithTagPriority merilis memori yang tidak berdampingan atau non-cache, itu harus berjalan di IRQL <= DISPATCH_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.20 dan yang lebih baru.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	Lihat bagian Keterangan.
Aturan kepatuhan DDI	NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)