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
NdisMAllocateSharedMemoryAsync
NdisMStartBufferPhysicalMapping