NdisAllocateMemoryWithTagPriority function

This topic has not yet been rated Rate this topic

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

A call to NdisAllocateMemoryWithTagPriority is equivalent to calling the NdisAllocateMemoryWithTag, function except that NdisAllocateMemoryWithTagPriority allows the caller to supply the priority of the request.

To free memory that was allocated with NdisAllocateMemoryWithTagPriority, call the NdisFreeMemory function.

Requirements

Version	Supported for NDIS 6.0 drivers in Windows Vista.
Header	Ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL

NdisAllocateMemoryWithTagPriority function