IHostMemoryManager::VirtualAlloc 方法
充当对应 Win32 函数的逻辑包装。 VirtualAlloc 的 Win32 实现将保留或提交调用进程的虚拟地址空间中的页面区域。
HRESULT VirtualAlloc (
[in] void* pAddress,
[in] SIZE_T dwSize,
[in] DWORD flAllocationType,
[in] DWORD flProtect,
[in] EMemoryCriticalLevel dwCriticalLevel,
[out] void** ppMem
);
参数
pAddress
[in] 一个指针,它指向要分配的区域的起始地址。dwSize
[in] 该区域的大小(以字节为单位)。flAllocationType
[in] 内存分配的类型。flProtect
[in] 要分配的页面区域的内存保护。dwCriticalLevel
[in] 指示分配失败的影响的 EMemoryCriticalLevel 值。ppMem
[out] 一个指向已分配内存的起始地址的指针;如果请求未能得到满足,则为 Null。
返回值
HRESULT |
说明 |
---|---|
S_OK |
VirtualAlloc 已成功返回。 |
HOST_E_CLRNOTAVAILABLE |
公共语言运行时 (CLR) 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。 |
HOST_E_TIMEOUT |
调用超时。 |
HOST_E_NOT_OWNER |
调用方不拥有锁。 |
HOST_E_ABANDONED |
事件在被阻止的线程或纤程正在等待它时被取消。 |
E_FAIL |
发生了未知的灾难性故障。 如果某方法返回 E_FAIL,CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。 |
E_OUTOFMEMORY |
没有可用于满足分配请求的足够内存 |
备注
通过调用 VirtualAlloc 将区域保留在进程的地址空间中。 pAddress 参数包含所需内存块的起始地址。 此参数通常设置为 Null。 操作系统将保留可用于进程的空闲地址范围的记录。 值为 Null 的 pAddress 指示系统在任何它认为合适的位置保留区域。 或者,您可以提供内存块的具体起始地址。 在这两种情况下,都会返回输出参数 ppMem 作为指向已分配内存的指针。 函数本身将返回 HRESULT 值。
Win32 VirtualAlloc 函数没有 ppMem 参数,并且会改为返回指向已分配内存的指针。 有关更多信息,请参见 Windows 平台文档。
要求
**平台:**请参见 .NET Framework 系统要求。
**头文件:**MSCorEE.h
**库:**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0