ExAllocatePoolWithQuotaTag function (wdm.h)
The ExAllocatePoolWithQuotaTag routine allocates pool memory, charging the quota against the current process.
ExAllocatePoolWithQuotaTag has been deprecated in Windows 10, version 2004 and has been replaced by ExAllocatePool2. For more information, see Updating deprecated ExAllocatePool calls to ExAllocatePool2 and ExAllocatePool3.
PVOID ExAllocatePoolWithQuotaTag( __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType, SIZE_T NumberOfBytes, ULONG Tag );
[in] Specifies the type of pool memory to allocate. For a description of the available pool memory types, see POOL_TYPE.
You can modify the PoolType value by bitwise-ORing this value with the POOL_QUOTA_FAIL_INSTEAD_OF_RAISE flag. This flag causes the routine to return a NULL value if the request cannot be satisfied.
Similarly, you can modify the PoolType value by bitwise-ORing this value with the POOL_COLD_ALLOCATION flag as a hint to the kernel to allocate the memory from pages that are likely to be paged out quickly. To reduce the amount of resident pool memory as much as possible, you should not reference these allocations frequently. The POOL_COLD_ALLOCATION flag is only advisory and is supported in Windows XP and later versions of the Windows operating system.
[in] Specifies the number of bytes to allocate.
[in] Specifies the pool tag for the allocated memory. For more information, see the Tag parameter of ExAllocatePoolWithTag.
ExAllocatePoolWithQuotaTag returns a pointer to the allocated pool.
If the request cannot be satisfied, ExAllocatePoolWithQuotaTag raises an exception unless POOL_QUOTA_FAIL_INSTEAD_OF_RAISE is specified. Using POOL_QUOTA_FAIL_INSTEAD_OF_RAISE is preferred for performance reasons.
This routine is called by highest-level drivers that allocate memory to satisfy a request in the context of the process that originally made the I/O request. Lower-level drivers call ExAllocatePoolWithTag instead.
If NumberOfBytes is PAGE_SIZE or greater, a page-aligned buffer is allocated. Memory allocations of PAGE_SIZE or less are allocated within a page and do not cross page boundaries. Memory allocations of less than PAGE_SIZE are not necessarily page-aligned but are aligned to 8-byte boundaries in 32-bit systems and to 16-byte boundaries in 64-bit systems.
The system associates the pool tag with the allocated memory. Programming tools, such as WinDbg, can display the pool tag associated with each allocated buffer. The value of Tag is normally displayed in reversed order. For example, if a caller passes 'Fred' as a Tag, it would appear as 'derF' if the pool is dumped or when tracking pool usage in the debugger.
In a non-uniform memory access (NUMA) multiprocessor architecture, ExAllocatePoolWithQuotaTag tries to allocate memory that is local to the processor that is calling ExAllocatePoolWithQuotaTag. If no local memory is available, ExAllocatePoolWithQuotaTag allocates the closest available memory.
|Minimum supported client||Available starting with Windows 2000.|
|Header||wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)|
|IRQL||<= DISPATCH_LEVEL (see Remarks section)|
|DDI compliance rules||HwStorPortProhibitedDDIs, SpNoWait, StorPortStartIo|