NdisMoveFromMappedMemory (Windows CE 3.0 Device Driver Developement)

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function copies data from device memory that was mapped during initialization with the NdisMMapIoSpacefunction 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 Lengthbytes in size.

Source

Specifies the base virtual address within mapped device memory from which to copy the data. This address must fall at least Lengthbytes 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 Sourceand Destinationpointers are virtual addresses. The virtual range specified by Sourceand Lengthmust fall within a range of device memory that was mapped during initialization with the NdisMMapIoSpacefunction.

A driver that calls this function can run at any IRQL when the given Sourceand Destinationare resident. Otherwise, callers must be running at IRQL < DISPATCH_LEVEL, as, for example if the Destinationaddress 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.

Last updated on Tuesday, July 13, 2004