IHostMemoryManager::VirtualFree 方法
用作相应 Win32 函数的逻辑包装器。 VirtualFree
的 Win32 实现将在调用进程的虚拟地址空间内释放、解除或释放并解除页面区域。
语法
HRESULT VirtualFree (
[in] LPVOID lpAddress,
[in] SIZE_T dwSize,
[in] DWORD dwFreeType
);
参数
lpAddress
[in] 指向要释放的虚拟内存页基址的指针。
dwSize
[in] 要释放的区域大小(以字节为单位)。
dwFreeType
[in] 释放操作的类型。
返回值
HRESULT | 说明 |
---|---|
S_OK | 已成功返回 VirtualFree 。 |
HOST_E_CLRNOTAVAILABLE | 公共语言运行时 (CLR) 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
HOST_E_TIMEOUT | 调用超时。 |
HOST_E_NOT_OWNER | 调用方未持有锁。 |
HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
HOST_E_INVALIDOPERATION | 尝试释放未通过主机分配的内存。 |
注解
VirtualFree
通过更早调用 IHostMemoryManager::VirtualAlloc 函数来释放与 lpAddress
参数关联的虚拟内存页。 尝试释放未通过主机分配的内存应返回 HOST_E_INVALIDOPERATION。
语义与 VirtualFree
Win32 实现的语义相同。 有关详细信息,请参阅 Windows 平台文档。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用