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
);

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 CE.

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
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

NDIS Library Functions
NdisAllocateMemory
NdisFreeMemory
NdisMSetAttributes
NdisMSetAttributesEx