共用方式為

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 封鎖的執行緒或 Fiber 在其上等候時，事件遭到取消。
E_FAIL 發生未知的重大失敗。 如果方法傳回 E_FAIL，則 CLR 就無法再用於處理序。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。
E_OUTOFMEMORY 記憶體不足，無法完成配置要求。

備註

CLR 會呼叫 IHostMemoryManager::CreateMalloc 方法，以取得 IHostMalloc 執行個體的介面指標。 DebugAlloc 可讓執行階段取得程式碼檔案資訊，以便在偵錯期間使用。

規格需求

平台：請參閱系統需求。

標題： MSCorEE.h

程式庫：包含作為 MSCorEE.dll 中的資源

.NET Framework版本：自 2.0 起提供

另請參閱