Funzione ExAllocatePoolQuotaZero (wdm.h)

Questa routine è un wrapper per e un'opzione di sostituzione consigliata per ExAllocatePoolWithQuotaTag.

ExAllocatePoolQuotaZero alloca la memoria del pool del tipo specificato e restituisce un puntatore al blocco allocato. È identico a ExAllocatePoolWithQuotaTag , ad eccezione di zero inizializza la memoria allocata. Se questo non è desiderato, usare invece ExAllocatePoolQuotaUninitialized .

Sintassi

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

Parametri

PoolType

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

Analogamente, è possibile modificare il valore PoolType in bit per bit-ORing con il flag POOL_COLD_ALLOCATION (definito anche in wdm.h) come hint per il kernel per allocare la memoria dalle pagine che potrebbero essere impaginate rapidamente. Per ridurre la quantità di memoria del pool residente il più possibile, non è consigliabile fare riferimento a queste allocazioni di frequente. Il flag di POOL_COLD_ALLOCATION è solo consultivo.

NumberOfBytes

Numero di byte da allocare.

Tag

Tag del pool da usare per la memoria allocata. Specificare il tag del pool come valore letterale di carattere diverso da zero di uno a quattro caratteri delimitati da virgolette singole (ad esempio, Tag1). La stringa viene in genere specificata in ordine inverso , ad esempio 1gaT. Ogni carattere ASCII nel tag deve essere un valore nell'intervallo 0x20 (spazio) per 0x7E (tilde). Ogni percorso del codice di allocazione deve usare un tag di pool univoco per aiutare i debugger e i verificatori a identificare il percorso del codice.

Valore restituito

ExAllocatePoolQuotaZero restituisce un puntatore al pool allocato.

Se la richiesta non può essere soddisfatta, ExAllocatePoolQuotaZero genera un'eccezione a meno che non sia specificato POOL_QUOTA_FAIL_INSTEAD_OF_RAISE. L'uso di POOL_QUOTA_FAIL_INSTEAD_OF_RAISE è preferibile per motivi di prestazioni.

Commenti

Per eseguire le versioni di Windows prima di Windows 10 versione 2004, il driver deve definire POOL_ZERO_DOWN_LEVEL_SUPPORT e chiamare ExInitializeDriverRuntime prima di chiamare questa funzione.

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 ExAllocatePoolZero .

Per altre indicazioni, vedere la sezione Osservazioni di ExAllocatePoolWithQuotaTag .

Requisiti

Vedi anche

ExAllocatePoolQuotaUninitialized