Fungsi NdisAllocateMemoryWithTagPriority (ndis.h)

Artikel
02/29/2024

Driver NDIS memanggil fungsi NdisAllocateMemoryWithTagPriority untuk mengalokasikan kumpulan memori dari kumpulan non-halaman.

Sintaks

PVOID NdisAllocateMemoryWithTagPriority(
  [in] NDIS_HANDLE      NdisHandle,
  [in] UINT             Length,
  [in] ULONG            Tag,
  [in] EX_POOL_PRIORITY Priority
);

Parameter

[in] NdisHandle

NDIS menangani pemanggil yang diperoleh selama inisialisasi. Misalnya, driver miniport dapat menggunakan handel NDIS yang diperolehnya dari Fungsi NdisMRegisterMiniportDriver atau MiniportInitializeEx . Driver NDIS lainnya dapat menggunakan handel dari fungsi berikut:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] Length

Ukuran yang akan dialokasikan, dalam byte.

[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.

[in] Priority

Pentingnya permintaan ini. Untuk mengetahui informasi selengkapnya, lihat ExAllocatePoolWithTagPriority.

Nilai kembali

NdisAllocateMemoryWithTagPriority mengembalikan penunjuk ke alamat virtual dasar memori yang dialokasikan, atau NULL jika memori yang tidak disebarkan yang cukup saat ini tidak tersedia.

Keterangan

Untuk membebaskan memori yang dialokasikan dengan fungsi NdisAllocateMemoryWithTagPriority, panggil fungsi NdisFreeMemoryWithTagPriority atau NdisFreeMemory .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_Miscellaneous_Function(ndis), NdisAllocateMemoryWithTagPriority(ndis), NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)