Share via

NetAllocateMdl (Compact 7)

  • Article

3/12/2014

This function allocates an MDL with an associated memory block of a specified size.

Syntax

PMDL
  NetAllocateMdl(
    IN PULONG  BufferSize
    );

Parameters

  • BufferSize
    The size of the memory block, in bytes. When calling NetAllocateMdl, NDIS passes in the requested size.

Return Value

NetAllocateMdl returns a pointer to the allocated MDL. If the allocation fails, the return value is NULL.

Remarks

If the NDIS driver specifies an entry point for the NetAllocateMdl function at the AllocateMdl parameter of the NdisRetreatNetBufferDataStart function, NDIS calls NetAllocateMdl to allocate an MDL and memory.

NDIS specifies the size of the associated memory block at BufferSize.

NetAllocateMdl can use any allocation method that meets the driver's design requirements. When NDIS calls the NetFreeMdl function to free the memory, the NDIS driver should free the memory by using the same memory management mechanism that it used to allocate the memory.

NDIS calls NetAllocateMdl at IRQL <= DISPATCH_LEVEL.

Requirements

Header

ndis.h

See Also

Reference

NDIS NET_BUFFER Functions
NetFreeMdl
NdisRetreatNetBufferDataStart