NdisAllocateMemoryWithTag (Compact 2013)

3/26/2014

This function allocates resident system-space memory.

Syntax

NDIS_STATUS NdisAllocateMemoryWithTag(
  PVOID* VirtualAddress,
  UINT Length,
  ULONG Tag
);

Parameters

• VirtualAddress
  [out] Points to a caller-supplied variable in which this function returns the base virtual address of the allocated memory or NULL if sufficient memory is currently unavailable.

• Length
  [in] Specifies the size in bytes to be allocated.

• Tag
  Unused in Windows Embedded Compact.

Return Value

The following table shows the return values for NdisAllocateMemoryWithTag.

Value	Description
NDIS_STATUS_SUCCESS	The caller can use the allocated memory range starting at the value returned at VirtualAddress.
NDIS_STATUS_FAILURE	An attempt to allocate the requested memory failed. This return does not necessarily mean that a subsequent call will fail.

Remarks

A call to NdisAllocateMemoryWithTag is equivalent to calling NdisAllocateMemory.

Requirements

Header	ndis.h
Library	ndis.lib

See Also

Reference

NDIS 5.x Legacy Functions
NdisAllocateMemory
NdisFreeMemory
NdisMSetAttributes
NdisMSetAttributesEx