Sdílet prostřednictvím


IHostMAlloc::DebugAlloc – metoda

Požaduje, aby hostitel přidělil zadané množství paměti z haldy a dále sledoval, kde byla paměť přidělena.

Syntaxe

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

Parametry

cbSize
[v] Velikost aktuálního požadavku na přidělení paměti v bajtech.

dwCriticalLevel
[v] Jedna z hodnot EMemoryCriticalLevel označující dopad selhání přidělení.

pszFileName
[v] Soubor kódu spustitelného souboru, který se ladí.

iLineNo
[v] Číslo řádku, ve pszFileName kterém bylo požadováno přidělení.

ppMem
[out] Ukazatel na přidělenou paměť nebo null, pokud požadavek nelze dokončit.

Návratová hodnota

HRESULT Description
S_OK DebugAlloc úspěšně vráceno.
HOST_E_CLRNOTAVAILABLE ClR nebyl načten do procesu nebo clr je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání.
HOST_E_TIMEOUT Časový limit hovoru vypršel.
HOST_E_NOT_OWNER Volající zámek nevlastní.
HOST_E_ABANDONED Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno.
E_FAIL Došlo k neznámému katastrofickému selhání. Když metoda vrátí E_FAIL, CLR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY K dokončení žádosti o přidělení nebylo k dispozici dostatek paměti.

Poznámky

CLR získá ukazatel rozhraní IHostMalloc instance voláníMem IHostMemoryManager::CreateMalloc metoda. DebugAlloc umožňuje modulu runtime získat informace o souboru kódu pro použití během ladění.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovny: Zahrnuto jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také