Funzione ExAllocatePoolPriorityUninitialized (wdm.h)
Questa routine è un'opzione wrapper e di sostituzione per ExAllocatePoolWithTagPriority.
ExAllocatePoolPriorityUninitialized alloca la memoria del pool del tipo specificato.
Sintassi
PVOID ExAllocatePoolPriorityUninitialized(
__drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
SIZE_T NumberOfBytes,
ULONG Tag,
EX_POOL_PRIORITY Priority
);
Parametri
PoolType
Tipo di memoria del pool da allocare. Per una descrizione dei tipi di memoria del pool disponibili, vedere POOL_TYPE.
È possibile modificare il valore di enumerazione eseguendo un'operazione OR bit per bit con il flag di POOL_RAISE_IF_ALLOCATION_FAILURE definito in wdm.h. Questo flag genera un'eccezione se la richiesta non può essere soddisfatta. L'uso di questo flag non è consigliato perché è costoso.
Analogamente, è possibile modificare il valore poolType bit per bit con questo valore con il flag POOL_COLD_ALLOCATION (definito anche in wdm.h) come suggerimento al kernel per allocare la memoria dalle pagine che è probabile che vengano visualizzate rapidamente. Per ridurre la quantità di memoria del pool residente il più possibile, non è consigliabile fare riferimento a queste allocazioni di frequente. Il flag POOL_COLD_ALLOCATION è solo consultivo.
NumberOfBytes
Numero di byte da allocare.
Tag
Tag del pool da usare per la memoria allocata. Per altre informazioni, vedere il parametro Tag di ExAllocatePoolWithTag.
Priority
Valore di enumerazione EX_POOL_PRIORITY che specifica la priorità di questa richiesta.
Valore restituito
exAllocatePoolPriorityUninitialized restituisce NULL se nel pool libero è presente memoria insufficiente per soddisfare la richiesta, a meno che non venga specificato POOL_RAISE_IF_ALLOCATION_FAILURE. In caso contrario, la routine restituisce un puntatore alla memoria allocata.
Osservazioni
Memoria che ExAllocatePoolPriorityUninitialized allocazioni non è inizializzata. Un driver in modalità kernel deve prima zero questa memoria se lo rende visibile al software in modalità utente (per evitare la perdita di contenuti potenzialmente privilegiati)
Per altre indicazioni, vedere la sezione osservazioni di ExAllocatePoolWithTagPrior ity.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Richiede WDK per Windows 10 versione 2004. È destinato a Windows 7 e versioni successive del sistema operativo Windows. |
| piattaforma di destinazione | Universale |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (vedere la sezione Osservazioni) |
| regole di conformità DDI | HwStorPortProhibitedDDIs, IrqlExAllocatePool, IrqlExFree2, SpNoWait, StorPortStartIo |