NdisMoveToMappedMemory (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 a system-space buffer to device memory that was mapped during initialization with the NdisMMapIoSpacefunction.

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

Parameters

Destination

Specifies the base virtual address within a mapped device memory range where the copy should begin. This address must fall at least Lengthbytes from the end of the mapped range.

Source

Pointer to a system-space buffer from which this function copies data to the destination range. This buffer must be at least Lengthbytes in size.

Length

Specifies the number of bytes to copy.

Remarks

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

Both the Sourceand Destinationpointers are virtual addresses. The virtual range specified by Destinationand Lengthmust fall within a range that was mapped 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 Sourceaddress 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