This function modifies the length specified in a buffer descriptor allocated or copied by the caller.
| Header file: | Ndis.h |
| Windows CE versions: | 2.0 and later |
VOID NdisAdjustBufferLength( IN PNDIS_BUFFER Buffer,
IN UINT Length );
The caller of this function can pass only a buffer descriptor that was allocated by the caller. It cannot pass a buffer descriptor that was allocated by another driver.
For example, the driver of a busmaster DMA NIC calls this function with buffer descriptors that it allocated to specify receive buffers in its shared memory block. Before such a driver indicates received data, it calls this function to make the buffer descriptor that it includes in the receive indication match the size of the received data if it is less than the size of the NIC’s receive buffer. When a receive packet with such an adjusted buffer descriptor has been consumed and returned to the miniport, the driver again calls this function to make the buffer descriptor match the actual size of its receive buffer again.
The Length parameter passed to this function cannot be larger than the Length that was passed to the NdisAllocateBuffer function when the buffer descriptor was allocated.
The caller of this function must restore the length to its original value before it frees the buffer descriptor with the NdisFreeBuffer function.
The driver must release any spin lock that it is currently holding before calling this function.
A driver calling this function can run at any IRQL, but usually runs at IRQL <=DISPATCH_LEVEL.
NdisAllocateBuffer, NdisFreeBuffer, NdisReleaseSpinLock