ExAllocatePoolQuotaZero 函式 (wdm.h)
謹慎
Microsoft知道 ExAllocatePoolQuotaZero 的問題,可能會導致 Windows 10 版本 1909 上未設為零的配置。此問題已在 2020 年 12 月 16 日 Windows 10 版本 2004 和 Enterprise WDK (EWDK) 的安全性重新整理中修正。 如需下載最新 WDK 的資訊,請參閱 下載 Windows 驅動程式套件 (WDK)。
此例程是 的包裝函式,也是 exAllocatePoolWithQuotaTag 的建議取代選項。
ExAllocatePoolQuotaZero 會配置指定類型的集區內存,並傳回所配置區塊的指標。 它與 ExAllocatePoolWithQuotaTag 相同,但零會初始化配置的記憶體。 如果不需要,請改用 ExAllocatePoolQuotaUninitialized。
語法
PVOID ExAllocatePoolQuotaZero(
__drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
SIZE_T NumberOfBytes,
ULONG Tag
);
參數
PoolType
要配置的集區內存類型。 如需可用集區內存類型的描述,請參閱 POOL_TYPE。
同樣地,您可以使用POOL_COLD_ALLOCATION旗標來修改 PoolType 值 wdm.h
,做為核心的提示,從可能快速分頁的頁面配置記憶體。 若要盡可能減少常駐集區內存的數量,您不應該經常參考這些配置。 POOL_COLD_ALLOCATION旗標只是諮詢。
NumberOfBytes
要配置的位元元組數目。
Tag
要用於已配置記憶體的集區標籤。 將集區標記指定為以單引號分隔之一到四個字元的非零字元常值(例如,Tag1
)。 字串通常會以反向順序指定(例如,1gaT
)。 標記中的每個 ASCII 字元都必須是範圍0x20(空格)中的值,才能0x7E(tilde)。 每個配置程式代碼路徑都應該使用唯一的集區標記來協助調試程式和驗證程式識別程式代碼路徑。
傳回值
ExAllocatePoolQuotaZero 會傳回配置集區的指標。
如果無法滿足要求,除非指定POOL_QUOTA_FAIL_INSTEAD_OF_RAISE,否則 ExAllocatePoolQuotaZero 會引發例外狀況。 基於效能考慮,最好使用POOL_QUOTA_FAIL_INSTEAD_OF_RAISE。
言論
若要在 Windows 10 版本 2004 之前的 Windows 版本上執行,驅動程式必須先定義POOL_ZERO_DOWN_LEVEL_SUPPORT,並在呼叫此函式之前呼叫 exInitializeDriverRuntime。
此例程是由配置記憶體以在原本提出 I/O 要求之進程內容中滿足要求的高階驅動程式所呼叫。 較低層級的驅動程式會改為呼叫 exAllocatePoolZero 。
如需其他指引,請參閱 ExAllocatePoolWithQuotaTag 的一節。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 需要適用於 Windows 10 版本 2004 的 WDK。 以 Windows 7 和更新版本的 Windows作系統為目標。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL (請參閱一節) |
DDI 合規性規則 | HwStorPortProhibitedDDIs、SpNoWait、StorPortStartIo |