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) 未加载到进程中,或 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
实现不会导致死锁,并且可以在用户代码中挂起随机线程时运行完成。 实现此方法的托管版本时,请谨慎操作。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用