NdisMUpdateSharedMemory 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.

NdisMUpdateSharedMemory ensures that data, just transferred from a bus-master NIC, to be read from driver-allocated shared memory is current.

Syntax

VOID NdisMUpdateSharedMemory(
  _In_ NDIS_HANDLE           MiniportAdapterHandle,
  _In_ ULONG                 Length,
  _In_ PVOID                 VirtualAddress,
  _In_ NDIS_PHYSICAL_ADDRESS PhysicalAddress
);

Parameters

MiniportAdapterHandle [in]
Specifies the handle originally input to MiniportInitialize.
Length [in]
Specifies the number of bytes in the range.
VirtualAddress [in]
Specifies the base virtual address within a range returned by NdisMAllocateSharedMemory or NdisMAllocateSharedMemoryAsync.
PhysicalAddress [in]
Specifies the physical address mapped to VirtualAddress.

Return value

None

Remarks

NdisMUpdateSharedMemory guarantees that any data written by the NIC is present in host physical memory at the virtual address returned by NdisMAllocateSharedMemory or NdisMAllocateSharedMemoryAsync on certain platforms. On any other platform, a call to NdisMUpdateSharedMemory has no overhead.

Requirements

Target platform	Desktop
Version	Windows Vista supports this function for legacy drivers. However, beginning with Windows Vista, the Windows Driver Kit (WDK) will not build an NDIS driver that calls this function.
Header	Ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL