NKCreateStaticMapping

This function creates a static virtual memory address that maps to a physical address. This function can be called from the OAL but not from the user code.

LPVOID NKCreateStaticMapping(
  DWORD dwPhysBase,
  DWORD dwSize
);

Parameters

  • dwPhysBase
    [in] Starting physical address to map. The address passed in must be shifted to the right by 8 bit positions.
  • dwSize
    [in] Number of bytes to map, starting from dwPhysBase.

Return Values

If the memory can be mapped, a valid static virtual memory pointer is returned. The virtual memory address that is returned represents an uncached memory region.

Remarks

NKCreateStaticMapping allows the OAL to map any physical address to a static virtual memory address, which can then be used in an ISR. An ISR can only access a static mapped virtual address. In previous releases, a static mapping could only be created at boot time and not created dynamically.

Once the static mapping is created, it is active until the device reboots.

NkCreateStaticMapping can also be called from the OAL to create a static mapping.

To use NKCreateStaticMapping, you must set WINCEOEM = 1.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Pkfuncs.h.
Link Library: Coredll.lib.

See Also

CreateStaticMapping | Configuring System Memory | Memory Addressing

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.