NdisAllocateMemoryWithTagPriority function (ndis.h)
NDIS drivers call the NdisAllocateMemoryWithTagPriority function to allocate a pool of memory from the non-paged pool.
Syntax
PVOID NdisAllocateMemoryWithTagPriority(
[in] NDIS_HANDLE NdisHandle,
[in] UINT Length,
[in] ULONG Tag,
[in] EX_POOL_PRIORITY Priority
);
Parameters
[in] NdisHandle
An NDIS handle that the caller obtained during initialization. For example, a miniport driver can use the NDIS handle that it obtained from the NdisMRegisterMiniportDriver or MiniportInitializeEx function. Other NDIS drivers can use the handles from the following functions:
[in] Length
The size to be allocated, in bytes.
[in] Tag
A string, delimited by single quotation marks, with up to four characters, usually specified in reversed order. The NDIS-supplied default tag for this call is 'maDN', but the caller can override this default by supplying an explicit value.
[in] Priority
The importance of this request. For more information, see ExAllocatePoolWithTagPriority.
Return value
NdisAllocateMemoryWithTagPriority returns a pointer to a base virtual address of the allocated memory, or NULL if sufficient nonpaged memory is currently unavailable.
Remarks
To free memory that was allocated with NdisAllocateMemoryWithTagPriority, call the NdisFreeMemoryWithTagPriority or NdisFreeMemory function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported in NDIS 6.0 and later. |
| Target Platform | Universal |
| Header | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI compliance rules | Irql_Miscellaneous_Function(ndis), NdisAllocateMemoryWithTagPriority(ndis), NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis) |