NdisAllocateMemoryWithTag (Windows Embedded CE 6.0)

1/6/2010

This function allocates resident system-space memory.

Syntax

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

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.

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.

A call to NdisAllocateMemoryWithTag is equivalent to calling NdisAllocateMemory.