IHostMemoryManager::VirtualQuery 方法
充当对应 Win32 函数的逻辑包装。 VirtualQuery 的 Win32 实现将检索有关调用进程虚拟地址空间中的页面范围的信息。
HRESULT VirtualQuery (
[in] void* lpAddress,
[out] void* lpBuffer,
[in] SIZE_T dwLength,
[out] SIZE_T* pResult
);
参数
lpAddress
[in] 一个指针,指向要查询的虚拟内存中的地址。lpBuffer
[out] 一个指针,指向包含指定内存区域相关信息的结构。dwLength
[in] lpBuffer 指向的缓冲区的大小(以字节为单位)。pResult
[out] 一个指针,它指向信息缓冲区返回的字节数。
返回值
HRESULT |
说明 |
---|---|
S_OK |
VirtualQuery 已成功返回。 |
HOST_E_CLRNOTAVAILABLE |
公共语言运行时 (CLR) 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。 |
HOST_E_TIMEOUT |
调用超时。 |
HOST_E_NOT_OWNER |
调用方不拥有锁。 |
HOST_E_ABANDONED |
事件在被阻止的线程或纤程正在等待它时被取消。 |
E_FAIL |
发生了未知的灾难性故障。 如果某方法返回 E_FAIL,CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。 |
备注
VirtualQuery 提供的信息涉及该调用进程的虚拟地址空间中的页面范围。 此实现将 pResult 参数的值设置为信息缓冲区中返回的字节数,并返回一个 HRESULT 值。 在 Win32 VirtualQuery 函数中,返回值将是缓冲区的大小。 有关更多信息,请参见 Windows 平台文档。
重要事项 |
---|
操作系统实现 VirtualQuery 不会引起死锁,在用户代码中具有挂起的随机进程的情况下,该实现过程可以一直运行直到完成。实现此方法的托管版时,请特别小心。 |
要求
**平台:**请参见 .NET Framework 系统要求。
**头文件:**MSCorEE.h
**库:**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0