Kernel32MapUserPhysicalPages(IntPtr, UIntPtr, UIntPtr) Method

[DllImportAttribute("Kernel32.dll", ExactSpelling = true, SetLastError = true)]
public static bool MapUserPhysicalPages(
	IntPtr address,
	ref UIntPtr refNumberOfPages,
	UIntPtr pageArray
)

<DllImportAttribute("Kernel32.dll", ExactSpelling := true, SetLastError := true>]
Public Shared Function MapUserPhysicalPages ( 
	address As IntPtr,
	ByRef refNumberOfPages As UIntPtr,
	pageArray As UIntPtr
) As Boolean

Dim address As IntPtr
Dim refNumberOfPages As UIntPtr
Dim pageArray As UIntPtr

Dim returnValue As Boolean

returnValue = Kernel32.MapUserPhysicalPages(address, 
	refNumberOfPages, pageArray)

public:
[DllImportAttribute(L"Kernel32.dll", ExactSpelling = true, SetLastError = true)]
static bool MapUserPhysicalPages(
	[InAttribute] IntPtr address, 
	UIntPtr% refNumberOfPages, 
	[InAttribute] UIntPtr pageArray
)

[<DllImportAttribute("Kernel32.dll", ExactSpelling = true, SetLastError = true)>]
static member MapUserPhysicalPages : 
        address : IntPtr * 
        refNumberOfPages : UIntPtr byref * 
        pageArray : UIntPtr -> bool 

No code example is currently available or this language may not be supported.

Parameters

address  IntPtr

A pointer to the starting address of the region of memory to remap.

The value of address must be within the address range that the VirtualAlloc(IntPtr, IntPtr, MemoryAllocationType, MemoryProtectionOptions) function returns when the Address Windowing Extensions (AWE) region is allocated.

refNumberOfPages  UIntPtr

The size of the physical memory and virtual address space for which to establish translations, in pages.

The virtual address range is contiguous starting at address. The physical frames are specified by the pageArray.

The total number of pages cannot extend from the starting address beyond the end of the range that is specified in AllocateUserPhysicalPages(IntPtr, IntPtr, IntPtr).

pageArray  UIntPtr

A pointer to an array of physical page frame numbers.

These frames are mapped by the argument address on return from this function.

The size of the memory that is allocated should be at least the refNumberOfPages times the size of the data type ULONG_PTR.

Caution: Do not attempt to modify this buffer. It contains operating system data, and corruption could be catastrophic. The information in the buffer is not useful to an application.

Return Value

If the function fails, the return value is and no mapping is done—partial or otherwise.

To get extended error information, call GetLastWin32Error.

Reference