Partager via


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

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

See also

MiniportInitialize

NdisFlushBuffer

NdisMAllocateMapRegisters

NdisMAllocateSharedMemory

NdisMAllocateSharedMemoryAsync

NdisMFreeSharedMemory

NdisMStartBufferPhysicalMapping

 

 

Send comments about this topic to Microsoft