NdisAllocateFromBlockPool function

Article
06/19/2017

Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

NdisAllocateFromBlockPool allocates memory from a block of memory pool.

Syntax

PUCHAR NdisAllocateFromBlockPool(
  _In_ NDIS_HANDLE BlockPoolHandle
);

Parameters

BlockPoolHandle [in]
Handle to the block to allocate from.

Return value

Returns a buffer if one can be allocated from the block; otherwise, it returns NULL.

Remarks

NdisAllocateFromBlockPool causes the driver-supplied initialization functionif it is suppliedto run once. This initialization function becomes associated with the block handle after NdisCreateBlockPool is called. The following describes the syntax of the driver-supplied initialization function:

VOID
(__stdcall *NDIS_BLOCK_INITIALIZER) (
    IN  PUCHAR  Block,
    IN  SIZE_T  NumberOfBytes
    );

The NdisFreeToBlockPool function is called to release memory back to the block.

Requirements

Target platform	Desktop
Version	Not supported for NDIS 6.0 drivers in Windows Vista. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP.
Header	Ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL.