Fungsi ExAllocatePoolPriorityZero (wdm.h)

  • Artikel

Perhatian

Microsoft mengetahui masalah dengan ExAllocatePoolPriorityZero yang dapat menyebabkan alokasi tidak dinol pada Windows 10, versi 1909. Masalah ini telah diperbaiki dalam refresh keamanan WDK untuk Windows 10, versi 2004 dan Enterprise WDK (EWDK) untuk Windows 10, versi 2004 pada 16 Desember 2020. Untuk informasi tentang mengunduh WDK terbaru, lihat Mengunduh Windows Driver Kit (WDK).

Rutinitas ini adalah pembungkus untuk dan opsi penggantian yang direkomendasikan untuk ExAllocatePoolWithTagPriority.

ExAllocatePoolPriorityZero mengalokasikan memori kumpulan dari jenis yang ditentukan.

Ini identik dengan ExAllocatePoolWithTagPriority kecuali nol menginisialisasi memori yang dialokasikan. Jika ini tidak diinginkan, gunakan ExAllocatePoolPriorityUninitialized sebagai gantinya.

Sintaks

PVOID ExAllocatePoolPriorityZero(
  __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
  SIZE_T                                         NumberOfBytes,
  ULONG                                          Tag,
  EX_POOL_PRIORITY                               Priority
);

Parameter

PoolType

Jenis memori kumpulan yang akan dialokasikan. Untuk deskripsi jenis memori kumpulan yang tersedia, lihat POOL_TYPE.

Anda dapat memodifikasi nilai enumerasi dengan melakukan bitwise-OR dengan bendera POOL_RAISE_IF_ALLOCATION_FAILURE yang ditentukan dalam wdm.h. Bendera ini menyebabkan pengecualian dinaikkan jika permintaan tidak dapat dipenuhi. Penggunaan bendera ini tidak disarankan karena mahal.

Demikian pula, Anda dapat memodifikasi nilai PoolType dengan bitwise-ORing nilai ini dengan bendera POOL_COLD_ALLOCATION (juga didefinisikan dalam wdm.h) sebagai petunjuk kernel untuk mengalokasikan memori dari halaman yang kemungkinan akan di-page out dengan cepat. Untuk mengurangi jumlah memori kumpulan penduduk sebanyak mungkin, Anda tidak boleh sering mereferensikan alokasi ini. Bendera POOL_COLD_ALLOCATION hanya nasihat.

NumberOfBytes

Jumlah byte yang akan dialokasikan.

Tag

Tag kumpulan yang digunakan untuk memori yang dialokasikan. Tentukan tag kumpulan sebagai literal karakter bukan nol dari satu hingga empat karakter yang dibatasi oleh tanda kutip tunggal (misalnya, Tag1). String biasanya ditentukan dalam urutan terbalik (misalnya, 1gaT). Setiap karakter ASCII dalam tag harus berupa nilai dalam rentang 0x20 (spasi) hingga 0x7E (tilde). Setiap jalur kode alokasi harus menggunakan tag kumpulan unik untuk membantu debugger dan verifier mengidentifikasi jalur kode.

Priority

Nilai enumerasi EX_POOL_PRIORITY yang menentukan prioritas permintaan ini.

Menampilkan nilai

ExAllocatePoolPriorityZero mengembalikan NULL jika memori di kumpulan gratis tidak cukup untuk memenuhi permintaan kecuali POOL_RAISE_IF_ALLOCATION_FAILURE ditentukan. Jika tidak, rutinitas mengembalikan penunjuk ke memori yang dialokasikan.

Keterangan

Untuk menjalankan versi Windows sebelum Windows 10 versi 2004, driver harus menentukan POOL_ZERO_DOWN_LEVEL_SUPPORT dan memanggil ExInitializeDriverRuntime sebelum memanggil fungsi ini.

Lihat bagian Keterangan dari ExAllocatePoolWithTagPriority untuk panduan tambahan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Memerlukan WDK untuk Windows 10, versi 2004. Menargetkan Windows 7 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL (lihat bagian Keterangan)
Aturan kepatuhan DDI HwStorPortProhibitedDDIs, IrqlExAllocatePool, IrqlExFree2, SpNoWait, StorPortStartIo

Lihat juga

ExAllocatePoolWithTagPriority

ExAllocatePoolPriorityUninitialized