NdisGetNextBuffer

This function returns the next buffer descriptor in a chain as long as it has a pointer to the current buffer descriptor.

At a Glance

Header file:	Ndis.h
Windows CE versions:	2.0 and later

Syntax

VOID NdisGetNextBuffer( IN PNDIS_BUFFER CurrentBuffer,
OUT PNDIS_BUFFER *NextBuffer );

Parameters

CurrentBuffer: Pointer to the current buffer descriptor.
NextBuffer: Pointer to a caller-supplied variable in which this function returns a pointer to the buffer descriptor, if any, that follows CurrentBuffer in the buffer descriptor chain.

Remarks

This function returns NULL at NextBuffer if CurrentBuffer points to the last buffer descriptor in the chain.

A driver usually calls this function after it calls the NdisQueryPacket or the NdisGetFirstBufferFromPacket function.

A driver can also call the NdisQueryBuffer function to get details about a buffer descriptor that this function finds.

This function does not perform any synchronization. Therefore, a caller must handle any synchronization issues internally if more than one driver function can access buffer descriptors chained to a packet simultaneously.

A driver that calls this function can run at any IRQL.