NdisMoveFromMappedMemory

This function copies data from device memory that was mapped during initialization with the NdisMMapIoSpace function to a system-space buffer.

VOID NdisMoveFromMappedMemory(
OUT PVOID Destination, 
IN PVOID Source, 
IN ULONG Length );

Parameters

• Destination
  Pointer to a system-space buffer into which this function copies data from mapped device memory. This buffer must be at least Length bytes in size.
• Source
  Specifies the base virtual address within mapped device memory from which to copy the data. This address must fall at least Length bytes from the end of the mapped range.
• Length
  Specifies the number of bytes to copy.

Remarks

An NIC driver calls this function to copy data from NIC memory into a buffer in the host, as, for example, when transferring received data into a protocol-supplied buffer or miniport-allocated staging buffer.

Both the Source and Destination pointers are virtual addresses. The virtual range specified by Source and Length must fall within a range of device memory that was mapped during initialization with the NdisMMapIoSpace function.

A driver that calls this function can run at any IRQL when the given Source and Destination are resident. Otherwise, callers must be running at IRQL < DISPATCH_LEVEL, as, for example if the Destination address is on the stack.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Ndis.h

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

NdisAllocateMemory, NdisMMapIoSpace, NdisMoveMappedMemory, NdisMoveToMappedMemory

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.