Funzione ExAllocatePoolWithQuota (wdm.h)

ExAllocatePoolWithQuota alloca la memoria del pool, la quota di ricarica rispetto al processo corrente.

Sintassi

PVOID ExAllocatePoolWithQuota(
  [in] __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
  [in] SIZE_T                                         NumberOfBytes
);

Parametri

[in] PoolType

Specifica il tipo di memoria del pool da allocare. Per una descrizione dei tipi di memoria del pool disponibili, vedere POOL_TYPE.

È possibile modificare PoolType usando un or bit per bit con il flag di POOL_COLD_ALLOCATION come suggerimento al kernel per allocare la memoria dalle pagine che potrebbero essere 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 avviso ed è disponibile per Windows XP e versioni successive del sistema operativo Windows.

[in] NumberOfBytes

Specifica il numero di byte da allocare.

Valore restituito

ExAllocatePoolWithQuota restituisce un puntatore al pool allocato.

Se la richiesta non può essere soddisfatta, ExAllocatePoolWithQuota genera un'eccezione.

Commenti

Questa routine viene chiamata dai driver di livello più alto che allocano memoria per soddisfare una richiesta nel contesto del processo che ha originariamente effettuato la richiesta di I/O. I driver di livello inferiore chiamano invece ExAllocatePoolWithTag .

Se NumberOfBytes è PAGE_SIZE o versione successiva, viene allocato un buffer allineato alla pagina. La quota non viene addebitata al processo per le allocazioni di PAGE_SIZE o maggiore.

Le allocazioni di memoria di meno di PAGE_SIZE vengono allocate all'interno di una pagina e non superano i limiti di pagina. Le allocazioni di memoria di PAGE_SIZE o meno non sono necessariamente allineate a pagine, ma sono allineate ai limiti a 8 byte nei sistemi a 32 bit e ai limiti a 16 byte nei sistemi a 64 bit.

Non impostare NumberOfBytes = 0. Evitare allocazioni a lunghezza zero perché rifiutino spazio di intestazione del pool e, in molti casi, indicano un potenziale problema di convalida nel codice chiamante. Per questo motivo, driver verifier contrassegna tali allocazioni come possibili errori.

Il sistema imposta automaticamente determinati oggetti evento standard quando la quantità di pool (paginata o non paginata) è elevata o bassa. I driver possono attendere che questi eventi ottimizzano l'utilizzo del pool. Per altre informazioni, vedere Oggetti evento Standard.

Memoria che ExAllocatePoolWithQuota alloca è 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).

I chiamanti di ExAllocatePoolWithQuota devono essere eseguiti in IRQL <= DISPATCH_LEVEL. Un chiamante in esecuzione in DISPATCH_LEVEL deve specificare un valore XxxnonPaged per PoolType. Un chiamante in esecuzione in IRQL = APC_LEVEL può specificare qualsiasi valore POOL_TYPE, ma l'ambiente e IRQL <deve essere considerato anche per determinare il tipo di pool.

Requisiti

Vedi anche

ExAllocatePoolWithQuotaTag

ExAllocatePoolWithTag

ExFreePool

POOL_TYPE