Fungsi ExAllocatePoolQuotaZero (wdm.h)

  • Artikel

Perhatian

Microsoft mengetahui adanya masalah dengan ExAllocatePoolQuotaZero 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 ExAllocatePoolWithQuotaTag.

ExAllocatePoolQuotaZero mengalokasikan memori kumpulan dari jenis yang ditentukan dan mengembalikan penunjuk ke blok yang dialokasikan. Ini identik dengan ExAllocatePoolWithQuotaTag kecuali nol menginisialisasi memori yang dialokasikan. Jika ini tidak diinginkan, gunakan ExAllocatePoolQuotaUninitialized sebagai gantinya.

Sintaks

PVOID ExAllocatePoolQuotaZero(
  __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
  SIZE_T                                         NumberOfBytes,
  ULONG                                          Tag
);

Parameter

PoolType

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

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.

Menampilkan nilai

ExAllocatePoolQuotaZero mengembalikan pointer ke kumpulan yang dialokasikan.

Jika permintaan tidak dapat dipenuhi, ExAllocatePoolQuotaZero mengajukan pengecualian kecuali POOL_QUOTA_FAIL_INSTEAD_OF_RAISE ditentukan. Menggunakan POOL_QUOTA_FAIL_INSTEAD_OF_RAISE lebih disukai karena alasan performa.

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.

Rutinitas ini disebut oleh driver tingkat tertinggi yang mengalokasikan memori untuk memenuhi permintaan dalam konteks proses yang awalnya membuat permintaan I/O. Driver tingkat bawah memanggil ExAllocatePoolZero sebagai gantinya.

Lihat bagian Keterangan dari ExAllocatePoolWithQuotaTag 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, SpNoWait, StorPortStartIo

Lihat juga

ExAllocatePoolQuotaUninitialized