NdisMoveToMappedMemory

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

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 Length bytes 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 Length bytes 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 Source and Destination pointers are virtual addresses. The virtual range specified by Destination and Length must fall within a range that was mapped 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 Source address is on the stack.

Requirements

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, NdisMoveFromMappedMemory, NdisMoveMappedMemory, NdisMoveMemory

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.