Expand Minimize

.pagein (Page In Memory)

The .pagein command pages in the specified region of memory.

.pagein [Options] Address

Parameters

Options

Any of the following options:

/p Process

Specifies the address of the process that owns the memory that you want to page in. (More precisely, this parameter specifies the address of the EPROCESS block for the process.) If you omit Process or specify zero, the debugger uses the current process setting. For more information about the process setting, see .process (Set Process Context)

/f

Forces the memory to be paged in, even if the address is in kernel memory and the version of the Microsoft Windows operating system does not support this action.

Address

Specifies the address to page in.

Environment

Modes

Kernel mode only (but not during local kernel debugging)

Targets

Live debugging only

Platforms

All

 

Remarks

After you run the .pagein command, you must use the g (Go) command to resume program execution. After a brief time, the target computer automatically breaks into the debugger again.

At this point, the address that you specify is paged in. If you use the /p option, the process context is also set to the specified process, exactly as if you used the .process /i Process command.

If the address is already paged in, the .pagein command still checks that the address is paged in and then breaks back into the debugger. If the address is invalid, this command only breaks back into the debugger.

In Windows Server 2003 and Windows XP, you can page in only user-mode addresses by using .pagein. You can override this restriction by using the /f switch, but we do not recommend that you use this switch. In Windows Vista, you can safely page in user-mode and kernel-mode memory.

Warning   If you use .pagein on an address in a kernel stack in Windows Server 2003 or Windows XP, a bug check might occur.

Requirements

Version

Supported in Windows XP and later versions of Windows.

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft