NdisAllocateMemoryWithTagPriority function

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

NdisHandle [in]

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:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

Length [in]

The size to be allocated, in bytes.

Tag [in]

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.

Priority [in]

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

Target platform

Universal

Version

Supported in NDIS 6.0 and later.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

Irql_Miscellaneous_Function, NdisAllocateMemoryWithTagPriority

See also

ExAllocatePoolWithTagPriority
FilterAttach
MiniportInitializeEx
NdisAllocateMemoryWithTag
NdisFRegisterFilterDriver
NdisFreeMemory
NdisFreeMemoryWithTagPriority
NdisMRegisterMiniportDriver
NdisOpenAdapterEx
NdisRegisterProtocolDriver

 

 

Send comments about this topic to Microsoft

Show: