ZwQueryVirtualMemory 函数 (ntifs.h)

ZwQueryVirtualMemory 例程确定主题进程的虚拟地址空间中页面区域的状态、保护和类型。

语法

NTSYSAPI NTSTATUS ZwQueryVirtualMemory(
  [in]            HANDLE                   ProcessHandle,
  [in, optional]  PVOID                    BaseAddress,
  [in]            MEMORY_INFORMATION_CLASS MemoryInformationClass,
  [out]           PVOID                    MemoryInformation,
  [in]            SIZE_T                   MemoryInformationLength,
  [out, optional] PSIZE_T                  ReturnLength
);

参数

[in] ProcessHandle

要查询的页面所在的进程的句柄。 使用 ZwCurrentProcess 宏指定当前进程。

[in, optional] BaseAddress

要查询的页面区域的基址。 此值向下舍入到下一个主机页地址边界。

[in] MemoryInformationClass

要检索信息的内存信息类。 目前,唯一受支持的 MEMORY_INFORMATION_CLASS 值是 MemoryBasicInformation

[out] MemoryInformation

指向接收指定信息的缓冲区的指针。 缓冲区的格式和内容取决于 MemoryInformationClass 参数中指定的指定信息类。 将 MemoryBasicInformation 的值传递给 memoryInformationClass时,MemoryInformation 参数值是 MEMORY_BASIC_INFORMATION 结构。

[in] MemoryInformationLength

指定内存信息缓冲区的长度(以字节为单位)。

[out, optional] ReturnLength

一个可选指针,如果指定,则接收内存信息缓冲区中放置的字节数。

返回值

如果调用成功,则返回STATUS_SUCCESS。 如果调用失败,可能的错误代码包括:

返回代码 描述
STATUS_INVALID_PARAMETER 指定的基址超出了可访问地址的范围。
STATUS_ACCESS_DENIED 调用方没有足够的访问权限来执行请求的操作。
STATUS_INFO_LENGTH_MISMATCH MemoryInformation 缓冲区大于 MemoryInformationLength。
STATUS_INVALID_INFO_CLASS MemoryBasicInformation 以外的值传递给 MemoryInformationClass 参数。

言论

ZwQueryVirtualMemory 确定区域中第一页的状态,然后从基址向上扫描进程地址映射中的后续条目,直到扫描整个页面范围或遇到具有非匹配属性集的页面为止。 区域属性、具有匹配属性的页面区域的长度以及相应的状态值将返回。

如果整个页面区域没有匹配的属性集,则可以使用 ReturnLength 参数值来计算未扫描的页面区域的地址和长度。

NtQueryVirtualMemoryZwQueryVirtualMemory 是同一 Windows 本机系统服务例程的两个版本。

对于内核模式驱动程序的调用,NtXxx**** 和 ZwXxx**** 版本的 Windows 本机系统服务例程的行为方式可能以不同的方式处理和解释输入参数。 有关 NtXxxZwXxx 例程之间的关系的详细信息,请参阅 使用 Nt 和 Zw 版本的本机系统服务例程

要求

要求 价值
最低支持的客户端 Windows 10
目标平台 普遍
标头 ntifs.h
NtosKrnl.lib
DLL NtosKrnl.exe

另请参阅

POWER_PLATFORM_INFORMATION