NdisCreateLookaheadBufferFromSharedMemory function

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.

NdisCreateLookaheadBufferFromSharedMemory returns the virtual address of a buffer within a block of memory shared with a bus-master DMA NIC.

Syntax

VOID NdisCreateLookaheadBufferFromSharedMemory(
  _In_  PVOID pSharedMemory,
  _In_  UINT  LookaheadLength,
  _Out_ PVOID *pLookaheadBuffer
);

Parameters

  • pSharedMemory [in]
    Specifies the base address of the shared memory range containing the data for the lookahead buffer.

  • LookaheadLength [in]
    Specifies the length in bytes for the lookahead buffer.

  • pLookaheadBuffer [out]
    Pointer to a caller-supplied variable in which this function returns the virtual address of the lookahead buffer.

Return value

None

Remarks

NdisCreateLookaheadBufferFromSharedMemory provides a lookahead buffer that is a virtual memory copy of shared memory for miniport driver receive indications. To bound protocol drivers, such a lookahead buffer represents a read-only version of the shared memory.

This function accommodates system architectures that do not allow the NIC driver to read shared memory on a network interface card directly.

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

Any level

See also

MiniportHandleInterrupt

MiniportTimer

NdisDestroyLookaheadBufferFromSharedMemory

NdisMArcIndicateReceive

NdisMEthIndicateReceive

NdisMFddiIndicateReceive

NdisMTrIndicateReceive

NdisMWanIndicateReceive

ProtocolReceive

 

 

Send comments about this topic to Microsoft