IHostMAlloc::DebugAlloc 方法

  • 项目

请求宿主从堆中分配指定数量的内存，并另外跟踪内存的分配位置。

语法

HRESULT DebugAlloc (  
    [in]  SIZE_T  cbSize,
    [in]  EMemoryCriticalLevel dwCriticalLevel,
    [in]  char*   pszFileName,
    [in]  int     iLineNo,
    [out] void**  ppMem  
);

参数

cbSize
[in] 当前内存分配请求的大小（以字节为单位）。

dwCriticalLevel
[in] EMemoryCriticalLevel 值之一，这些值指示分配失败的影响。

pszFileName
[in] 所调试的可执行文件的代码文件。

iLineNo
[in] 请求分配操作所在的 pszFileName 中的行号。

ppMem
[out] 指向已分配内存的指针，如果请求无法完成，则为 null。

返回值

HRESULT 说明
S_OK 已成功返回 DebugAlloc。
HOST_E_CLRNOTAVAILABLE CLR 未加载到进程中，或 CLR 处于无法运行托管代码或无法成功处理调用的状态。
HOST_E_TIMEOUT 调用超时。
HOST_E_NOT_OWNER 调用方未持有锁。
HOST_E_ABANDONED 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。
E_FAIL 发生未知的灾难性故障。 当方法返回 E_FAIL 时，进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。
E_OUTOFMEMORY 内存不足，无法完成分配请求。

注解

CLR 通过调用 IHostMemoryManager::CreateMalloc 方法获取指向 IHostMalloc 实例的接口指针。 DebugAlloc 允许运行时获取代码文件信息，以便在调试期间使用。

要求

平台：请参阅系统要求。

标头：MSCorEE.h

库：作为资源包含在 MSCorEE.dll 中

.NET Framework 版本：自 2.0 起可用

另请参阅